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Your Aquarius is designed to Country TV System Voltage TV Channel 
operate within the locality in 
which it was purchased. 





United Kingdom PAL | 240 E-36 
Because of local receiver 
requirements, your computer Canada 7 NTSC rg sor 4 
is tailored to operate on one Germany PAL B 220 E3 or E4 
only of the following television 
channel designations. Italy PAL B 220 AorB 
VHF Oor | (switch selected) France SECAM 220 E-36 
VHF A or B (switch selected) 
VHF 3 or 4 (switch selected) Scandinavia PAL B 220 E3 or E4 
UHF 36 (U.K. or South Africa) 

Benelux PAL B 220 E3 or E4 
In VHF models, a selector Seicatcall ec - 
switch can be found on the aici 0 a 
rear of Aquarius to allow Austria PAL B 220 E3 or E4 
selection of an unused 
channel in your area. Spain PAL B 220 E3 or E4 
“It should also be noted that South Africa PAL | 220 E-36 
operation of Aquarius should 
not be done simultaneously Australia PAL B 240/250 0 or 1 
while using any form of TV 
video game as serious Japan NTSC 100 1 or 2 


interference may result. 
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KEY POINTS FOR TROUBLE 
FREE USE OF YOUR 
AQUARIUS™ HOME 
COMPUTER SYSTEM 


1. Place Aquarius on a flat, 
sturdy surface, so the air vents 
on the bottom can do their 
job. Do not place ON 
CARPETED SURFACES. 


2. Keep fingers out of the 
open end of the program 
cartridges and cartridge 
port(s). 


3. Never lift Aquarius by any 
external wires, or by the Mini 
Expander, or its hand 
controllers. 


4. Protect both program 
cartridges and Aquarius from 
excessive heat. 


5. Always insert cartridge port 
dust cover when port is not in 
use. 


6. Turn Aquarius OFF and 
disconnect unit from mains 
when not in use. 





NEW PRODUCT NEWS 


4 COLOR PRINTER 


QD FLOPPY DISK DRIVE 








Features 

e Selectable blue, red, green 
and black color printing. 

e Exchangeable color pen. 

e Selectable 40 or 80 column 
printing. 

e 12 characters/second print 
rate. 

e 256 characters including 
upper and lower case 
letters and graphics. 

e Directly connect to 
Aquarius printer interface. 














Features 
e Built-in AQ-DOS. 
e Connection up to 2 drives. 


e 102.4K bytes formatted per 
drive. 


e Maximum 80 files per 
diskette. 


e Data Rate 101.5625K Baud. 
e Access time 2-8 sec. (max) 
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INTRODUCTION 


PN@Ley NUS 
GUIDE 
TO 
HOME 
COMPUTING 






Dear User: 


That’s you, the proud, new owner of an AQUARIUS home com- 
puter. Congratulations on a purchase that may prove to be the 
most valuable tool you ever buy. Because AQUARIUS is one of 
the most versatile tools you can buy. Once you learn how to com- 
municate with it, you can use AQUARIUS to expand and enrich 
many areas of your life: business, play, home management, 
education...and you can play great games with it as well! 


If there are children in your home, you may have to schedule in 
time on your computer. Experience has shown that children 
take to computers like bears take to honey. Don’t worry. 
Aquarius is sturdy enough to take on child programmers, as 
well as their adult counterparts. 


If the AQUARIUS computer is your first computer, you’re in for 
a pleasant surprise. YOU DON’T NEED A MATH DEGREE to pro- 
gram a computer. The AQUARIUS computer is easy to use. Ina 
short time you can be off and running, writing your own com- 
puter programs in the BASIC language. A few hours will ac- 
quaint you with the essential commands you need. And it’s FUN. 
What a feeling of satisfaction comes with running your first 
successful program. It’s enough to make an old programmer 
envious! 


So relax, follow the easy hook-up instructions, then prop this 

book beside your computer and let it guide you through a fasci- 
nating new world. When you see examples or experiments, type 
them in and run them to see how they work. 

















Keep an eye out for special ‘‘road signs’’ in this book. They point 
to tips and facts that will make your computer experience 

















Some stationary game patterns 
produced by this product may be 
permanently imprinted on Projec- 
tion TV tubes by extended use at 
high brightness levels. Consult 
Projection TV Owner's manual 
before use of this product. 
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THE AQUARIUS 
PUTER SYSTEM 
COMPUT SYS 1/O (Input/Output) PORTS. Input 
or Output devices (tape recorder 
and printer) plug into your com- 
puter here. 





YOUR AQUARIUS” COMPUTER 
(With built-in BASIC language) 


CARTRIDGE PORT. Accepts pre- 
programmed Aquarius game car- 
tridges or the Aquarius Mint 

Expander Module. 









KEYBOARD. Used to type in in- 
formation or instructions and play 


games. Many keys print entire POWER 
BASIC commands in a single ON/OFF 
keystroke, when used with the POWER ON SWITCH. 


CTL (Control) key. INDICATOR LIGHT. 


Note: Power plugs not. 
included for U.K. unit. 


TV HOOK-UP CABLE with 
ANTENNA SWITCH BOX. 
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- hard copy for program or data. 


INPUT/OUTPUT 





DEVICES 


AQUARIUS ™ Mini Expander 

Module _ Jwo ports allow pro- 
gram cartridge to interact with 
additional memory (4K and 16K 
memory cartridges). Includes 2 
more sound channels and hand 
controllers for game play. 


AQUARIUS™ Printer (40 col- 
umn) Provides permanent 


(Each sold separately) 













AQUARIUS™ Data Recorder 
Uses standard cassette tape to 
store program permanently. 





AQUARIUS™ 4-COLOR 
PRINTER 

Provides 4 color graphic 
printouts as well as 40/80 
columns alphanumeric printing. 


AQUARIUS™ QD FLOPPY 
DISK DRIVE 

A 100K Bytes economical and 
efficient device to store 
program permanently. 














HOOK-UP WITHOUT 


HANG-UPS 





Carefully unpack your 
computer. Check to make 
sure that you have all of these 
parts: 
Computer 
Power Cord with attached 
transformer 
Television Hook-Up Cable 
(10 foot) 
Antenna Switch Box 


(See illustration of these parts 
on page 4.) . 


BEFORE YOU CONTINUE... 
Take a minute to check the 
bottom of your computer. 
You will see two number — a 
model number and a serial 
number. Jot these numbers 
down on page 2 of this 
section, in the spaces 
provided 








FIND A PLACE FOR YOUR COMPUTER TO LIVE. Look for a flat, 
sturdy surface, so the air vents on the bottom of your computer 
can do their job. Computers prefer a temperate climate. Avoid 
placing it near a heating or air conditioning source. The TV 
connecting cabe is 10 feet long, so position your computer within 
that distance, near a “standard” wall outlet. Be sure AC plug has 


been properly installed. 





CONNECT YOUR COMPUTER © 
TO YOUR TV SET. Plug the 
TV connecting cable into the 
computer and the antenna switch 
box, aS shown. 








The antenna switch box allows 
you to use your TV screen as the 
video monitor for your computer. 
To connect the two, you will 
need a screwdriver (flat head 
and/or phillips head, depending 
on your TV set). Follow the illus- 
trations on the next page. 


INSTALLATION WITH FLAT, 


“TWIN LEAD” ANTENNA WIRE: 





Seeeeeeeeeeeeeeseseseeee sé 





























INSTALLATION WITH ROUND, 
“COAX” ANTENNA WIRE: 





SPECIAL HOOK-UP 
INFORMATION 


Some newer televisions have a 
separate input port for a cable 
television. AQUARIUS” can be 
hooked up directly to this port 
with the use of a standard 
‘Balun’’ converter (available at 
most electronics stores). 


If you own a video game, you 
can hook up the video game 
along with your AQUARIUS” 
computer to the same television 
set, with the use of a video 





switch, also available at most 
electronics stores, or at Radio 
Shack (catalog number 15-1254). 





NOTE: NO CHANGE TO YOUR 
UHF ANTENNA CONNECTION 
IS REQUIRED FOR EITHER 
TYPE OF INSTALLATION. 





If applicable, find the Channel 
3/Channel 4 selector switch 
on the back of your comput- 
er. Set it to whichever chan- 
nel has the weaker reception 
in your area. (Use a small 
screwdriver or the tip of a ball 
point pen, as the switch is 
recessed.) When you use 
your computer, refer to inside 
front cover chart for channel 
selection appropriate to your 
location. 

















If you disregard any of the follow- 
ing rules you may Cause interfer- 
ence to nearby television sets. 


HELPFUL HINTS ON 
INTERFERENCE 


e Never attach loose wires to 
your antenna terminals 
when you are using your 
computer. 


e The Antenna Switch Box 
comes with its own twin 
lead wire. Never substitute 
a longer twin lead wire 
from the Antenna Switch 
Box to your television set. 


Do not attach the twin lead 
wire from the Antenna 
Switch Box to any 
television antenna or cable- 
TV outlet. 
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IF YOU ARE USING YOUR 
BSR ERE REE COMPUTER WITH A 


EEE EERE RRR CASSETTE RECORDER, 
MEER REE REE CONNECT THE TWO 
DEVICES, AS SHOWN 
BELOW: 





Your Aquarius” home computer 
comes with a plastic overlay that 
fits over the keyboard. This over- 
lay is your guide to keys that will 
print entire BASIC words when 
these keys are pressed 
TOGETHER WITH the CTL key. 
The BASIC word is printed on the 






INSERT 5-PIN PLUG 
ON CABLE INTO 
CASSETTE JACK 
ON COMPUTER. 


INSERT EAR PLUG ON 


overlay ABOVE the key to be 2 Te 
used with the CTL key. Details / . 
on how these keys work is on REM PLUG ISNOT \wceer Mic PLUG 
page 5 of Chapter 1. ON CABLE INTO 
MIC JACK ON 


RECORDER. 

PLUG CASSETTE 

POWER CORD 

INTO STANDARD 

WALL OUTLET. 
IF YOU ARE USING YOUR 
AQUARIUS COMPUTER WITH 
A PRINTER, CONNECT THE 
PRINTER TO YOUR COMPUTER 
FOLLOWING THE DIRECTIONS 
THAT COME WITH YOUR 
PRINTER. 





READY TO POWER UP! 


e Plug your Aquarius 
computer into.a standard 
AC wall outlet. 


e Set the Antenna Switch Box 
at COMPUTER. 


e Turn your television set on. 
e Turn your Aquarius 
computer on. In a few 


seconds you will see this 
display. 


BASIC 


Press RETURN key to start 
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The screen color will change dur- 
ing this display. Tune your TV set 
for color, clarity and sharpness. 


Then press the (Return) 
key. The display will change to: 


Copyright © 1982 by Microsoft, Inc. 
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TURNING YOUR 
AQUARIUS™ 


COMPUTER OFF 





First turn your TV set off. 
Then, turn the Aquarius off. 


Restore Antenna Switch Box 
to TV position (otherwise 
normal reception will be very 
weak or noisy). 


lf you turn your Aquarius 
computer off before you turn 
your TV set off, the TV acts 
as though you are getting 
very poor reception. A picture 
may or may not be visible on 
the screen. If the sound is 
turned up, you will hear a 
loud hissing noise. You didn’t 
do anything harmful to your 
TV. Simply turn your TV set 
off. 








COMPUTER TALK 
Nobody wants to read 
a dictionary. But these 
key words will help you get a 
handle on some concepts you'll 
be dealing with as you learn to 
use your computer. Other key 
words will be explained at the 
end of each chapter in this book. 
Get acquainted with them...you'll 
be doing yourself a favor. 


DATA. Another word for INFOR- 
MATION. !t's WHAT YOU 
WORK WITH when you write a 
program. Some. data is perma- 
nently stored in the computer's 
memory. Most data is supplied 
by you. 


EXECUTE. Another way of saying 
“perform” or ‘‘carry out’. We 
speak of executing a com- 
mand. 


RUN. A command that tells the 
computer to execute the in- 
Structions in a program. 














INPUT. As a verb, it is the proc- 
ess of entering data into the 
computer, using the keyboard. 
As a noun, it is data which is 
entered into memory. 


OUTPUT. As a verb, it is the 


process of giving out data 
from the computer. As a noun, 
it is data from the computer, 
given in any form (printed on 
paper, displayed on a TV 
screen, etc.). 


RAM (Random Access Memory). 


The computer's ‘‘working 
memory’’. You temporarily 
store a program in RAM when 
you write, edit or run the pro- 
gram. But RAM is not forever. 
When you turn your computer 
off, data stored in RAM is 
erased. The length of program 
you can run is determined by 
the amount of RAM available 
in your computer. (You have 
1781 bytes available. More on 
this on page 9 of Chapter 10.) 





ROM (Read Only Memory). The 


computer's ‘‘permanent 
memory’’. You can not erase 
or edit data stored in ROM. 


You can only instruct the com- 


outer to READ data in ROM 
and manipulate it. Most of the 
computer's internal operating 
instructions are stored in 
ROM. 
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The Aquarius is set up and ready 
for you to program in BASIC. 
BASIC is what we call a ‘‘high- 


BASIC has a total ‘‘vocabulary’’ 
of about 60 words and a few 
symbols. The words, which are 
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" CHAPTER 1 level’’ language. This means that called KEYWORDS, are all de- ia 
— BASIC commands more closely fined in the Reference Section of e 
resemble the language we speak this book. The words you will use 2 

é aa C- ETTING than they do the language that most often are explained in detail te 
= re FEET the computer ‘'speaks’’. This throughout the next 9 chapters. a 
Y UR L makes BASIC an easy language We will start with fundamental os 

— WET” for people to use. (Though the concepts and simple keywords gi 
ae ene computer needs its own built-in and build from there. | 
| : : interpreter.) | 
a | (Modes, Arithmetic, | 
a RTN Key, RUN, NEW, ; 
CONT, LIST, PRINT, | 

a CTL Key, | ss : 
= Editing Features) THATS EASY 3 
= FOR You , | 
os TO SAY | | 
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Is your computer ‘‘powered up’ 
(turned on) and ready to go? lf 
not, flip back to page 8 in the In- 
troduction Section and follow the 
steps to display this screen: 


Copyright © 1982 by Microsoft, Inc. 
Ok. 
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CURSOR PROMPT 


Pay particular attention to the 
objects labeled PROMPT and 
CURSOR. You will be seeing 
them quite often. 





KEY IDEAS 

The word Ok is the 
PROMPT. This ap- 
pears whenever the Aquarius is 
ready to receive your instruc- 
tions. 








- Saal 





The black square is the 
CURSOR. It marks the next posi- 
tion on the screen where a letter, 
number, symbol or space will ap- 
pear when you press a key on 
the keyboard. The cursor helps 
you keep track of ‘where you 
are’ on the screen. 
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You can use your Aquarius” 
Computer in two different ways, 
or MODES. In one mode, 
Aquarius" responds immediately 
to each instruction you type, as 
soon as you press the RTN key. 
For this reason, it is called the 
IMMEDIATE Mode. (Some peopie 
call it the Direct Mode.) 


In the second mode, Aquarius is 
a little more patient. It lets you 
enter entire lists of instructions 
and does not execute them until 
you tell it to do so. These lists of 
instructions are what we call 
‘programs’, so this mode Is 
called the PROGRAMMED Mode. 
(Of course!) 


_ There are other differences be- 


tween Immediate and Pro- 
grammed Modes. For example, 
instructions are called 
COMMANDS in Immediate Mode 
and are NOT numbered. Instruc- 
tions are called STATEMENTS in 
Programmed Mode and ARE 








numbered. These LINE 
NUMBERS let the computer 
know which mode you are in and 
are very important. We'll explain 
them in detail later in the 
chapter. 


OK 
PRINT “HELLO” @ 





COMMAND IN IMMEDIATE MODE 


Ok 
10 PRINT “HELLO” 
a 





STATEMENT IN PROGRAMMED MODE 


RTN — 


THE ACTION KEY! 


The key is the key that 
makes things happen. (RTN is 
short for Return.) In Immediate 
Mode, it tells Aquarius” to exe- 
cute the command you just gave. 
In Programmed Mode, it tells 
Aquarius” to store the statement 
you just typed, so that it can be 
executed when you are finished 
writing your program. IF YOU 
DON’T PRESS THE KEY 
AFTER TYPING IN EVERY COM- 
MAND OR STATEMENT, 
NOTHING WILL HAPPEN. 


The key also sends the 


cursor to the beginning of the 
next line, so you're ready to type 
your next command or state- 
ment. 


Key is also marked RETURN 
on the overlay, but this is another 
animal altogether. Don’t confuse 
the two keys or you will end up 
confusing yourself. 





PLAYING WITH 
IMMEDIATE MODE 





Type in this line: 
PRINTH’ HELLO” 


BY THE WAY 
=} The symbol! nr means 
SPACE. When you 
see this symbol, press the 
SPACE key. We will only use this 


symbol when there is an impor- 
tant reason to include a space. 





Now press the key to 


enter the command. Did 
Aquarius print HELLO? 


Press again to drop down 


another line. Then type 
this: PRINT 2+4 and press 
RTN. Did Aquarius print 6? 











Try another one. Type: PRINT 5*3 and press | RTN }. Aquarius 
should have printed 15. Surprised? Maybe you didn't recognize the 
asterisk (*) aS a multiplication sign. 





ARITHMETIC KEYS 


In BASIC we use these keys to do arithmetic operations. 





(UPPER CASE) _ to add Example: 2 + 2 





(lower case) to subtract Example: 16 — 12 





(UPPER CASE) _ to multiply Example: 5 * 8 





(lower case) to divide Example: 20 / 4 








You can also EXPONENTIATE (raise a number to a power) with the a 
symbol. Example: 8 a 2 = 8 to the second power (or 8 squared) = 64. 





BY THE WAY 
YOU CANNOT DIVIDE BY 0. 








= 





ARITHMETIC OPERATIONS — 
WHICH COMES FIRST? 


If you combine more than one 
arithmetic operation in the same 
expression (example: 5 + 16/ 
4), which operation does the 
computer do first? Does it add 5 
+ 16, then divide the result by 
4? Or does it divide 16 by 4 and 
add 5 to the result? The order of 
precedence makes a difference 
in the answer. 


Here’s how your Aquarius " Com- 


outer deals with the question. It 
scans the expression from left to 
right, looking for arithmetic 
operations in this order: 


Parentheses 

Exponentiation 

Negation (giving a number a 
negative value, like ~— 5) 
Multiplication and.division 
Addition and subtraction 
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Example 1:5 * 6 + 4/ 2 


Aquarius first multiplies 5 * 6, 
then divides 4 by 2. It then adds 
the results of these operations 
(30 + 2) for a final result of 32. 
This is a different result than if 
Aquarius had multiplied 5 * 6, 
then added 4 and divided that 
result by 2, for a final answer of 
V7. | 


Example 2:5 * (6 + 4) / 25 


Aquarius first adds 6 + 4 
(because this operation is in 
parentheses). Then it multiplies 
the result (10) by 5 and divides 
that result (50) by 25. The final 
answer is 2. 


The order in which Aquarius 
does arithmetic operations is 
called OPERATOR 
PRECEDENCE. For more infor- 
mation on operator precedence, 
see page 11 in the Appendix: 


There are other kinds of expres- 
sions, too, called RELATIONAL 
and LOGICAL expressions. These 
are discussed in a later chapter. 





NOTES ABOUT NUMBERS. 
When you use numbers in 
BASIC, they cannot contain 
commas or special characters, 
like the dollar sign. 


$1,250.75 NO 


1250375 YES 


CONTROL — 





THE SHORTCUT KEY 


The key marked CTL is called 
the CONTROL key. When used 
with another key, it allows us to 
take shortcuts in writing many 
keywords. To use the 
key, always HOLD IT DOWN 
while pressing the other key — 
the same way you use the 
SHIFT key to type upper case 
characters. RUN and LIST are 
examples of keywords that can 
be ‘‘written’’ using the 
key with another key. Almost 
every key on the keyboard can 





be combined with the key 
to instantly ‘‘write’’ a keyword or 
do an editing function. Pretty 
handy, huh? These keys are all 
marked on the keyboard overlay. 


There is a list of CTL shortcuts 
for the keywords and editing 
functions you learn in each 
chapter. These lists are at the 
end of each chapter. 


When a key is to be used with 
the key, the combination 
is written as CTL-(key). FOR EX- 
AMPLE, CTL-C ‘‘MANUALLY’”’ 
HALTS A PROGRAM THAT IS 
RUNNING. (This key is marked 
STOP on the overlay.) 





CHAPTER 1 








RUN, NEW, 


CONT, LIST 





The most frequently used com- 
mands in Immediate Mode are 
those that tell the computer to do 
something with a PROGRAM. 
Some of these are: 


RUN — Tells Aquarius to 
EXECUTE the instructions in a 
program. Type RUN and press 


[RTN ]. Or press [CTL J—[11 ] 
| RTN J. 


and then 


NEW — Tells Aquarius to 
ERASE a program from 
memory. Type NEW and press 
[ RTN ]. There is no control 


shortcut for this command. 


CONT — CONT means 
CONTINUE. It tells Aquarius to 
resume executing the program 
after it has been halted by a 
STOP statement in the pro- 
gram. (See pages 12 and 13 in 
the Reference Section for 
details.) There is no CTL short- 
cut for this command. 


LIST — Tells the computer to 
PRINT A LIST of the instruc- 


tions in a program. Type LIST 
and press | RTN |. Or press 
| CTL | —[2 | and then | RTN |. 


There are two different ways to 
list a program: 


e Type LIST only. Aquarius will 
print your entire program, one 
screenful at a time. When the 
screen fills up, listing will stop. 
To see the next screenful, press 
any key except [CTL ] 
or LRST |. 

e Type LIST and a line number. 
Aquarius will print your entire 
program, beginning with that line 
number, one screenful at a time. 
To see the next screenful, press 
any key except [ CTL ], 
or [RST ] 

e To STOP LISTING when you 


reach a line you want to change, 


press [ CTL ]—[ C ]. This will 
temporarily take you out of LIST, 
so you can edit. (See How To 
Edit, page 10.) To continue 
listing, when you are finished 


editing, type LIST and press 
_RTN |. 





THE RESET KEY 


RST 





When you press the RST (short 
for Reset) key, you go back to 
the first screen display you saw 
when you turned your Aquarius 
on. On this screen is the instruc- 
tion: 


BASIC 


Press RETURN key to start 


lf you press the RTN key after 
pressing RST, you will see the 
screen display with the copyright 
notice. EVERYTHING STORED 
IN MEMORY (RAM) WILL BE 
ERASED. If you have a program 


in RAM, it will be erased. In com- 


puter talk, this is called a ‘‘cold 
Start’. 
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There is also something called a 
“warm start’, which allows you 
to use the RST key WITHOUT 
erasing the memory. Simply 
press | CTL |}-[ C ] (the STOP key) 
after | RST |, instead of the RTN 
key. A ‘‘warm start’ is important 
in two situations: 


1. You pressed the RST key by 
mistake. 


2. Your computer experienced 
a ‘‘system crash’. This means 
that Aquarius overloaded — it 
had a ‘‘nervous breakdown”. If 
a program is running, it stops. 
No key on the keyboard 
works...except RST. 


When you press CTL-C (STOP) in- 
stead of RTN, for a ‘‘warm 
Start’, you see a Break 
message, such as: 


Break in 30 
Ok 





Your stored Program and the 
variables used in that program 
are still in RAM. Any variables 
you had used in Immediate Mode 
are erased. After a ‘‘warm start’’ 
enter the RUN command to 
begin running your program 
again, from the start. 


PLAYING WITH 
PROGRAMMED 
MODE 





Let's start with a clear slate. 
Press the [ RST | key, then the 
key. This will take you 
back to the copyright notice that 
you started with when you turned 





your computer on. There are 
other ways to clear the screen, 
but this is the simplest way for 
now. (Note: This erases the 
screen AND anything stored in 
memory.) 


Type these statements, exactly 
as you see them here: 


10 PRINT “HELLO” 

(and press [_RTN J) 
20 PRINT 2 + 4 

(and press [ RTN ]}) 


You do not have to type key- 
words (like PRINT) in upper case 
letters. Aquarius automatically 
Stores keywords in upper case 
letters, no matter how you type 
them. You will see this when you 
LIST your program. 


ALWAYS PRESS AT THE 
END OF EVERY STATEMENT 
YOU TYPE. Remember that in- 
dividual statements in Pro- 
grammed Mode are NOT ex- 


ecuted when you press | RTN |. 


The secret is in the line numbers. 


They tell Aquarius to store those 
Statements in its memory, until 
you are ready to RUN them as a 
program. 





CHAPTER 1 








i. 


Try it! Type RUN and press 
| RTN |. You should see this: 


Ok 

10 PRINT “HELLO” 
20 PRINT 2 + 4 
HELLO 

6 


Ok 





Now type LIST and press 

| RTN |. Aquarius will print your 
Statements 10 and 20, just as 
you originally typed them. 


Our little program is good prac- 
tice, but not really worth saving. 
So type NEW and press FaTN I 
This erases the program from the 


computer's memory. It does NOT 
erase the screen. 


Notice how you are switching 
back and forth between Im- 
mediate and Programmed 
Modes. When you type state- 
ments with line numbers, you are 
in Programmed Mode. When you 


type RUN to execute those 
statements (or LIST or NEW), you 
are in Immediate Mode. 





MORE ABOUT 
LINE NUMBERS 


Just a few simple rules... 


1. Whole numbers (integers) only. 
Not 10.5 or 10%. 


2. Positive numbers only. Not 
— 10. 


3. Numerals only. Not 10A. 


4. Largest possible line number 
— 65529. 66000 is too large. 


lf you try to enter a statement 
with an invalid line number, you 
will get a SYNTAX ERROR (SN 
ERROR) message. This means, 
‘you goofed — try again.” 
(There is a complete list of all er- 
ror messages, starting on page 1 
of the Appendix.) 





If you try to enter a line number 
that is too large, Aquarius will 
chop off digits, working from 
right to left, until it cuts your line 
number down to a size it can 
handle. This process is called 
TRUNCATING. Example: 66,000 
would become 6600. And you 


would still get the error message. 


What’s more, if you already had 
a line 6600 in your program, the 
new line 6600 would REPLACE 
the old line 6600. And that could 
mean big trouble. 





inSng GOOD HABITS 
Kk As a general rule, 
leave gaps of at least 
10 between line numbers. 





Example: 10 PRINT ‘‘HELLO’’ 
20 PRINT ‘‘MY NAME 
So. 


Then if you need to add state- 
ments in later, you can do so 
without renumbering. 
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BACK TO PRINT 





What have you noticed about the 
keyword PRINT? So far we have 
seen it followed by either: 


e Characters enclosed in quotes 
(called LITERALS)... 
PRINT ‘‘Hello”’ 

e An equation (the = sign is 
understood) NOT enclosed in 
quotes...PRINT 2+5 


PRINT can also be followed by 
VARIABLES (which you will learn 
about in Chapter 2) or a com- 
bination of literals, equations 
and variables...PRINT A+B. 


When the PRINT command is 
followed by LITERALS, Aquarius 
prints EVERYTHING inside the 


_ quotes, exactly as it is typed. 


When the PRINT command Is 
followed by an EQUATION, 
Aquarius prints only the RESULT 
of the equation. (When Aquarius 
prints numbers, it prints a — 
sign in front of negative 
numbers and leaves a blank 


space in front of positive 
numbers.) 


What happens if you forget the 
quotes around a literal? 


Type: PRINT HELLO and 
press [RTN ]. 


Your Aquarius quickly informs 
you of your mistake by printing 
SN ERROR. (Syntax Error... 
remember?) 


Or what if you place quotes 
around an equation? Try it and 
see. Type: PRINT ‘2 * 5” 
and press [ RTN ]. This time you 
don't get an error message, but 
you don't get the result of your 
equation either. To get the best 
of both worlds, combine literals 
and equations with a SEMI- 
COLON. 


Type this: 
Pan 2 ee = aS” eS 


When you press | RTN |, 
Aquarius will print: 
2 * 5 = 20. 


ANOTHER ALTERNATIVE: If you 
type PRINT “2” + “5” and 





press [ RTN ]. Aquarius will print 
these TWO LITERALS next to 
each other. (This is called CON- 
CATENATION.) The result will be 
20. If you place quotes around 
only ONE number in an equation 
(PRINT ‘‘2” + 5), Aquarius will 
get totally confused and give 
you a TM Error message (TM 
means Type Mismatch — you 
tried to mix apples and oranges.) 





BY THE WAY 
= } AN ABBREVIATION 
FOR THE PRINT 
COMMAND IS THE QUESTION 
MARK (?). EXAMPLE: 


2 HELLO” or 7 2%. 5 
fing) Computers are fast, 
but unimaginative. 

They only do EXACTLY what you 
tell them to do. In general, every 
quote, comma, semi-colon, etc. 
has a very specific meaning. If 
you substitute one for another, 
you change the meaning of your 
command or statement. 
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Spaces are a little different. Sometimes they have a specific meaning. the same. YOU MUST STILL 
Most of the time though, they serve their “‘normal’’ function — to make PRESS TO ENTER YOUR 
a line more READABLE. The computer usually does not view them as COMMAND OR STATEMENT. 
necessary. For example, you can type: 1OPRINT'2*5=";2*5 and Otherwise the computer will treat 
you will still see 2*5 = 10 when you run the program. the second line as a continuation 


of the first line. 


There may be times when you 
ry WANT this to happen (if you 
HOW TO EDIT have a statement that won't fit 
on one line, for example). In this 
case, you can type UP TO AND 
INCLUDING COLUMN 34 on 
the second line, before press- 
TERED LELL LLL EEE Enprn ing [RTN ]. This makes a total of 
BEEEEEEEEEEE EEE EEE EEE EEE 72 characters — the MAXIMUM 
LINE LENGTH. When you have 
typed 72 characters (including 
spaces), Aquarius will BUZZ and 
BEE refuse to print any further char- 
PEEEEEEEEEEEEEEEECEEE EEE sea a og at 





LINE LENGTH Think of the screen as 40 columns across by 24 rows 
down. 


ww 
sem 
pce ptn ttt 
aee 
aa moh 


a 
a 
& 
% 
a 
Sahar an Ok 

10 PRINT “HELLO” 
20 PRINT 2 + 4 





Normally you can type characters in columns 1 through 38. Aquarius shodedstil imnoperstuevwiyriZMSarnbet23 
usually reserves columns 0 and 39 as margins. 456789012345678901234567890 123456 M 


If you type a character or space in column 38, the cursor will auto- 
matically return to column 1 on the next line. THIS IS NOT THE SAME 
AS PRESSING THE KEY, though the immediate result may look 





COLUMN 34 
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(Pressing | RTN |, of course, 


ends your statement.) 


If you want to continue a PRINT 
statement over 2 lines, you may 
need to break it up in a special 
way, to make it READABLE when 
it is run. 


TYPE THESE LINES EXACTLY 
AS YOU SEE THEM HERE: 


10 PRINT ‘‘FORESCORE AND 
SEVEN YEARS ”’ ; 


PRESS [| RTN |. 


20 PRINT ‘‘ m AGO, OUR ...”’ 


PRESS [RIN ]. 


Don't forget the SEMI-COLON at 
the end of Line 10. (More on 
punctuation use in Chapter 2.) 


Now RUN this program. Notice 
that the computer types ‘‘ago” 
right after ‘years’. This happens 
because you placed the SEMI- 
COLON at the end of your literal 
(‘‘Forescore and seven years’’) 
on line 10. The space between 
years and ago appears because 
you typed a space before “‘ago”’ 
in line 20. You could also have 
typed the space AFTER ‘‘years”’ 
in line 10. 


DELETE CHARACTERS 


In BOTH Immediate and Pro- 
grammed Modes, you can erase 
all or part of a line BEFORE YOU 
PRESS | RTN |. You do this by 
pressing the |~\| key. Each time 
you press this key, the cursor 
backs up one space, erasing the 
character over which it passes. 
(CTL-H does the same thing.) 


TYPE: PRINT HELLO ... then 
press [~\] twice, to see how it 
works. 


If you want to make a change 
AFTER you press [ RTN ], simply 
re-type the line. In Programmed 
Mode, TYPE THE LINE NUMBER 
TOO. You can re-type a program 
statement anywhere on the 
screen. The new statement will 
replace the old statement, as 
long as both have the same line 
number. 





DELETE PROGRAM LINE 


In Programmed Mode, you can 
delete an entire line BEFORE you 
press | RTN |. Use the control 
shortcut, LCTL }-[X ]. (This key is 
marked DELINE on the overlay.) 
A # sign will appear at the end of 
the line and the line will be 
deleted, as you will notice when 
you LIST or RUN your program. 


To delete a line AFTER you press 


| RTN |, just type the line number 
and press | RTN |. See example 
on the next page. 
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10 PRINT ‘‘HELLO AQUARIUS: You type in these 3 statements. eS 
20 PRINT ‘SOLVE THIS.”’ Remember to press after 

a0 PRINT “2 b= “2285 each statement. aw 

20 Now you type the line number 20 iw 

and press | RTN |. es 

LIST Enter LIST to display your = 

program. _ 

10 PRINT ‘‘HELLO AQUARIUS"' Notice that Line 20 is gone! - 

30 PRINT “2 * 53 = "7245 = 

| 

ADD A PROGRAM LINE TYPE: = 

“ 

In Programmed Mode, you can 10 PRINT ‘‘HELLO’’ You enter a 4-statement = 

add statements to a program in 20 PRINT ‘‘PLEASE SOLVE”’ program. _ 

any order, at any time. The LINE 30 PRINT ‘‘THIS EQUATION"’ Remember to press after w 

NUMBER determines the order AQ: PRINT “2 9 12.2 "2 2512 each statement. a 

in which a statement appears in tod 

your program. 15 PRINT ‘‘AQUARIUS"’ You pick a line number between _ 

10 and 20. The line number must _ 

For example, suppose that you not already exist in your pro- ia 

wanted to add a PRINT state- gram. If you use an existing line aa 

ment between Lines 10 and 20 number, your new statement will Ne 

in this program: replace an existing statement. és 

After typing in your new line ww 

number, you type in the a 

statement. ba 

LIST You enter the LIST command to — 


] 
5 


display your revised program. 





Oc 








10 PRINT ‘HELLO’ 
15 PRINT ‘‘AQUARIUS”’ 


In your new program, Line 15 is 
properly placed between Lines 
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20 PRINT ‘‘PLEASE SOLVE"’ 
30 PRINT ‘‘THIS EQUATION”’ 
40 PRINT ‘'2 * 12 ="; 2*12 


10 and 20. 





CLEAR SCREEN (CHR$) 


Earlier you learned that you can 
clear the screen and erase 
memory by pressing [ RST ], then 
[RTN ]. What if you want to 
clear the screen WITHOUT eras- 
ing the memory? Type this com- 
mand: 


PRINT CHR$(11) 
or 
?CHRS(1 1) 


NOTE: The QUESTION MARK is 
short for PRINT. CTL-(Space key) 
is the shortcut for CHR$. The 
space key is marked CHR$ on 
the overlay. (Of course, you Still 
have to type PRINT or ? before 
CHR$ and press after it.) 


When you press | RTN |, the 


screen will clear and the cursor 
will return to the HOME POSI- 


TION (upper left corner of the 
screen). 


PRINT CHR$(11) can be used to 
clear the screen in either Im- 
mediate or Programmed Mode. 
In Programmed Mode, type it as 
you would any numbered state- 
ment. When the program is run 
and Aquarius reaches that state- 
ment, it will clear the screen and 
continue the program. 


CHR$ is an example of a com- 
puter function. Functions are ex- 
plained Jater in the book. Don't 
worry about understanding this 
function now. It’s okay to just 
use it for the time being. 


00k COMPUTER TALK 


COMMAND. An instruction with- 
out line numbers used in 
Immediate Mode. 





CONCATENATION. The act of 
joining things together. 


CURSOR. A pointer (in our case, 
a black square) that marks the 
next screen position in which 
you can type a character or 
space. 


EXPONENTIATION. The process 
of raising a number toa 
power, that is, multiplying it by 
itself a number of times. 


HOME POSITION. The upper left 
corner of the screen. 


INTEGER. A whole number. 
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INTERPRETER. A device that 
‘‘translates’’ your BASIC com- 
mands into the machine lan- 
guage that the computer 
understands. 


LINE NUMBER. Any positive 
integer preceding a statement 
in Programmed Mode. 


LITERAL. Anything enclosed in 
quotation marks that is to be 
printed exactly as typed. 


MODE. A way of doing things. 


PROMPT. Character (s) that tells 
you the computer is ready for 
your input. Aquarius uses OK 
as its prompt. 


STATEMENT. An instruction with 
line number, used in Pro- 
grammed Mode. 


TRUNCATION. The act of 
shortening a number or string 
of characters by dropping 
numbers or characters, start- 
ing from the right. 





Ne) 


% CONTROL 


q SHORTCUT 
@a=-8 


CHR$...[CTL } [= | 


LIST..[ CTL ]-2 ] (and press 
| RTN_J) 


RUN... CTL }[ 1 ] (and press 
_RTN }) 


Delete program line...[CTL }-[X] 
(marked DELINE on overlay) 


Delete character...[ CTL }(_H ] 
Halt program execution... 
STEHT C] (marked STOP on 


overlay) 
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CHAPTER 2 


“DIVING IN” 


(Golam clitclelissr 
INPUT, LET, Reserved 
| Words, Punctuation) 








When you write a program, you 
give Aquarius instructions 
(statements or commands) that 
tell it to do something with data. 
(Remember data? That’s our 
word for information.) 


Before we look at any more in- 
Structions, let’s look at the differ- 
ent kinds of data we can have. 
Data can be: 


1. CONSTANT information which 
DOES NOT CHANGE from 
the way you write it. 

2. VARIABLE information which 
YOU OR THE COMPUTER 
CAN CHANGE when your pro- 
gram is run. 


Either kind of data can consist of 
NUMBERS ONLY or a COMBI- 
NATION of numbers, letters, 
spaces and special characters. 
Data that consist of numbers 
only are called NUMERIC DATA. 


Data that COMBINE letters, num- 


bers, etc. are called STRING 
DATA. So we end up with four 
different kinds of data: 

NUMERIC CONSTANTS, STRING 
CONSTANTS, NUMERIC 


VARIABLES and STRING 
VARIABLES. 


CONSTANTS 





NUMERIC CONSTANTS 


In Chapter 1, when we used the 
PRINT instruction, we used it 
with both numeric and string 
constants. When we did ARITH- 
METIC OPERATIONS we used 
NUMERIC CONSTANTS. Exam- 
ple: PRINT 2 + 5. 2and5 
are both numeric constants. 
ONLY NUMERIC constants or 
variables can be used in arith- 
metic operations. 


Numeric Constants 


545 (an integer) 
— 17 (a negative number) 


29.45 (a decimal number. Can 
also be negative.) 


3.2E06 (a number larger than 
999999, expressed in scientific 


notation. This is scientific nota- 


tion for 3200000.) 














9E-03 (a number smaller than 
.01 expressed in scientific 


notation. This is scientific nota- 


tion for .009.) 
STRING CONSTANTS 


When we printed LITERALS 
(characters inside quotation 
marks), we used STRING CON- 
STANTS. ‘Hello, Aquarius” is a 
string constant. ‘2 + 5” is also 
a string constant. When numbers 
are enclosed in quotation marks, 
we cannot perform arithmetic 
operations on them, because 
‘they are STRING constants (also 
called LITERAL STRINGS). If we 
tell Aquarius to PRINT ‘'2” + 
“SD, it will print the 2 and the 5 
next to each other. (Concatena- 
tion...remember?) 


String Constants 
945" or 5" + 4” 
(Numbers only) 


‘Hello’ (letters only) 


“Pi =3.14%"' (a combination 
of letters, numbers & special 
characters.) 


VARIABLES 





If you have a program that works 
only with constants, you have a 
program that cannot change 
when you run it. You cannot in- 
teract with a program like this .. 
you can only watch it. A program 
that doesn't let you interact is 
not much of a program. 


In order to allow interaction, a 
program must work with 
VARIABLES, as well as con- 
stants. Think of a variable as an 
empty box that you can fill with 
any data you like. Once you 
Store data in the box — we call 
this ASSIGNING A VALUE to the 
variable — Aquarius ™ treats that 
value as a constant until you 
decide to put a different value in 
the box. You can put either a 
numeric value or a string value 
into the box — but you cannot 
mix these two kinds of values in 
the same box. 





Once you store a value in a box, 
you need to LABEL the box, so 
that you can find (retrieve) that 
value when you want to use it. 
String variables have different 
labels than numeric variables. 


NUMERIC VARIABLE NAMES 
A...Any single letter 
AB...Two letters, if unreservedt 


SCORE...A name up to approxi- 
mately 60 characters in 
length, if unreservedt. 
(Aquarius uses only the first 
two letters, so it would con- 
sider this example to be the 
label SC.) | 


C5...A combination of a letter 


and a number. The letter must 
be the first character. 


t SEE NOTE AT TOP OF PAGE 2-3. 
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STRING VARIABLE NAMES t Note: The words listed here are all ‘‘RESERVED”’ because they have 

special significance to the BASIC interpreter. No variable name can in- 

A$...Any single letter, followed clude letter combinations that spell one of these words. For example, 

by a dollar sign. (Example: A$ “BONUS” would not be a valid variable label because it contains ine 
= ‘‘Hello’’.) sequence O-N — and that’s a reserved word. 

NAMESS...Groups of letters up ABS —s~ODIM LEFT$ ON RETURN STOP 
to approximately 60 charac- AND END LEN OR RESTORE STR$ 
terst, followed by a dollar ASC ~ EXP LET PEEK RIGHT$ TAB 
sign. (Aquarius uses only the CHR$ FOR LIST POINT RND TAN 
first two characters and the CLEAR FRE LLIST POKE RUN . THEN 

COPY IF MIDS PRINT SOUND VAL 

C8$...Any letter and number, fol | COS INKEYS$ =NEW PSET SPC 
lowed by a dollar sign. The let. | CSAVE = INPUT NEXT READ SQR 
ter must be the first character. | DATA INT NOT REM STEP 


(ALL THESE WORDS ARE EXPLAINED IN DETAIL IN THE REFERENCE 
SECTION. ALL WORDS ABOVE THAT END IN A $ CAN BE USED 
WITHOUT THE $ AS NAMES FOR NUMERIC VARIABLES.) 
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INPUT — THE 
INTERACTIVE 


INSTRUCTION 





That's not as weighty as it sounds. But INPUT is a very important state-. 


ment, because it lets you use variables to create a program that you 


can interact with. 


INPUT tells Aquarius to STOP RUNNING THE PROGRAM so you can 
enter (or input) some data with the keys. There are two ways to write 


an INPUT statement. 


10 “WHAT |S YOUR NAME”: 


20 INPUT NA$ 


The print statement asks the 
question. You do not need a 
question mark after NAME 


_ because the INPUT statement in 


line 20 automatically prints a 
question mark. The semi-colon at 
the end of the PRINT statement 
causes the question mark to ap- 
pear at the end of line 10. 


The input statement tells the 
computer to stop and wait for 
you to answer. Then it stores 
that answer under the label NA$. 
The dollar sign at the end of the 
label tells Aquarius to expect 
“string’’ data. 





The second way to write an 
INPUT statement is on one line, 
without the PRINT statement. 


10 INPUT “WHAT IS YOUR 
NAME"”’:NAS$ 


This is obviously a faster way to 
write an INPUT statement. 

Enter and run the short program, 
‘DAYS OLD", to see how the 
INPUT statement works. 





REMINDER 

If you make any mis- 
takes before complet- 
ing a line, move the cursor 
backward for corrections with 
the [~']. If you discover an error 
after you have finished the line 
and pressed [ RTN ], just type 
the line again, using the same 
number. 








REMEMBER TO PRESS 
AT THE END OF EVERY PRO- 
GRAM LINE! 
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“DAYS OLD” 





PROGRAM 


10 }NPUT *‘Hi..what’s your name’’: 
NAS 


20 PRINT ‘‘How old are you,n’';NA$; 





EXPLANATION 


The words inside quotation 
marks are constant data, and will 
be displayed just as you write 
them. 


The semicolon separates the 
constant part of the statement 
from the variable part of the 
statement. 


NA$ is a label for your name (the 
variable you will type in when the 
program asks for it.) The dollar 
sign at the end of the label tells 
the computer to expect ‘'string”’ 
data. Then this data will get put 
into a memory location labeled 
NAS. 


Again, the words between the 
quotation marks are constant. 
Notice the blank space after the 
‘you, ’. It’s needed there to put a 
space between the last word of 
the constant data and the first 
letter of the variable data. 


This line tells the computer to get 
the data you stored in the 
variable NA$ (your name) out of 
its memory and PRINT it right 
after the constant data. 
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30 INPUT age 


This line tells the computer to ex- 


pect the input of a numeric 
variable, which it can use to do 


When you have entered this pro- 
gram, RUN it to see how it 
works. 


arithmetic calculations. Omission 
of the dollar sign defines the 
variable ‘age’ as numbers-only 
data. 


40 PRINT age;:''! That's pretty young!"’ This line tells Aquarius to get the 
data you stored in the numeric 
variable ‘age’ and print it before 
the constant data. 
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LET 
The INPUT statement allows you to assign a value to a variable when Notice that the word LET is op- _ 
you RUN a program. The LET statement allows you to assign a value to tional in a LET statement. Also ~ 
a variable when you WRITE a program. Then when you run your pro- notice that you cannot normally ed) 
gram and Aquarius reads your LET statement, it automatically assigns assign a numeric value to a 7 
the value you chose to the variable you named. string variable or vice versa. i 
WITH LET: LETA = 10 WITHOUT LET: A = 10 Once you assign a value toa od 
LETA=2+4+5 A=2+5 variable, it keeps that value until ea 
LETA=B+C A=B+C you assign a different value or es, 
LETA=B A= 8 use that variable in an INPUT — 
LETA=B+5 A=B++5 statement. = 
LET A$ = “Hello” A$ = “Hello” “ 


# 
J 


C 


INCORRECT LET A$ = 5 
INCORRECT LET A = “Hello” 


Let's update our “DAYS OLD” 
program, using the LET statement. 
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PROGRAM 


10 INPUT ‘‘Hi..what’s your name’’: 
NAS 


20 ? ‘How old are you,n’’;NA$: 
30 INPUT age 
40 LET DAYS = age*365 


NUMERIC CONSTANT 


90 ? ‘That's at least’’;DAYS;’’m days.’’ 


EXPLANATION 


The first 3 statements are the 
same as our previous program. 
Notice we used the ? instead of 
the word PRINT in line 20. 


The word LET is optional in a 
LET statement. We could omit it 
and get the same result. With 
Line 40 we create another 
numeric variable (DAYS) which 
equals the numeric variable age 
times the numeric constant 365. 


Again, a PRINT statement con- 
tains both constant and variable 


data. The second semicolon tells 


the computer that there is more 


to be displayed on the same line. 
The blank space before the literal 


‘days’ puts a space between 
the variable and the constant. 





anfh§ GOOD HABITS 
On Ged li'sa good idea to 
lattes LIST your programs, 


to check for any obvious errors. 


As you see, the statements 
INPUT, PRINT and LET are 
Capitalized, as well as the 
variable names — even if you 
didn't type them that way. 


Try your program now. Press 
[OTL HL] then [RTN]). You 
should see the lines shown on 
the next page. 
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PROGRAM 
Ok 
RUN 


Hi, what's your name? 


How old are you, (your name)? 
That's at Jeast (result) days! 


Ok 





EXPLANATION 


Type your name now. Then 


PRESS [| RTN |. 


Type in your age now. 





DID YOU HAVE ANY PROB- 
LEMS? Don’t worry — it's a 
chance to learn more. If there 
were any ‘‘bugs”’ in your pro- 
gram that kept it from running, 
you got an Error Message show- 
ing the number of the first line 
the computer encountered that it 
could not execute. Check the list 
of Error Message abbreviations 
on pages 2 and 3 of the Appen- 
dix to see what the message 
means. The process of finding 
and correcting errors is called 
‘debugging’, and it’s an in- 
evitable part of programming. A 
common cause of errors, even 
by experienced programmers, is 
mistyping or omitting punctuation 
(quotation marks and semicolons 
in this example). 


If your program wouldn't RUN, 
press [CTL 2], then 
to LIST your program. Double- 
check each punctuation mark. 
And make sure you were consis- 
tent in spelling all the variable 
names. 





SBeseseesese & & 


Seseeeseseeeseseece 
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When you find an error, just 
type the whole line again, using 
the same number. When you 
press [RTN ], your new line 
replaces the old one. 


PUNCTUATION 





When your program runs perfect- 
ly, do some experimenting to 
demonstrate the usefulness of 
other kinds of punctuation. There 
are three special punctuation 
marks that you need to be aware 
of. 


SEMI-COLON () 


e CAN BE USED TO SEPARATE 

constants and variables in a 

statement. This use is optional. 

Example: 

10 PRINT ‘‘My name isn’’;A$;"". 
What's yours?’’ 

e Causes a variable or constant 

to be printed NEXT TO another 

variable or constant. 

Example: 

10 PRINT ‘‘! am your computer.n”’; 

20 PRINT ‘‘You are my user.’ 


If these statements were ex- 
ecuted, Aquarius would print: 
‘| am your computer. You are 
my user.’’ on one line. 


COMMA (,) 


e SEPARATES variables when 
more than one variable is used in 
the same statement. 

Example: 

10 INPUT A$,B$,C$ 


e Causes a variable or constant 
to be printed in the automatic 
TAB position, which is column 1 
or column 15 on a line. If either 
column is already occupied, the 
data is printed in the next auto- 
matic tab position. 

Example: 


10 PRINT “‘Red’’, ‘Blue’, ‘‘Yellow’’, 


‘‘Green’’ 





lf this statement were executed, 
Aquarius would print: 


Red 
Yellow 





COLON (:) 


The colon can be used (optional- 
ly) to separate statements, allow- 
ing you to write more than one 
program statement on a single 
line. This is probably the way you 


will use the colon as you gain ex- 


perience, but the early examples 
in this book will show each state- 
ment on a different line. (Com- 
bined statements are explained 
in Chapter 5.) 
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BY THE WAY 

Any time a punctua- 
om = (ON) Mark iS used 
INSIDE quotation marks, it is 
used as a LITERAL character.’’ 
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BUG. An error in a program. 








CONSTANT. Data that cannot 
be changed during program 
run. 


DEBUGGING. The process of 
correcting errors. 


LABEL. The ‘‘name”’ under 
which you store variable data. 


LITERAL STRING. Constant data 
that is enclosed in quotation 
marks. Also called string 
constant. 


NUMERIC CONSTANT. Constant 
data that can be used in arith- 
metic operations. A number. 








NUMERIC VARIABLE. A variable 
whose value can be a number 
only. 


RESERVED WORDS. Words that 
have special meanings and 
therefore cannot be used, in 
whole or part, as variable 
names. 


STRING CONSTANT. Constant 
data that is enclosed in quota- 
tion marks. Also called literal 
string. 


STRING VARIABLE. A variable 
which can contain letters, 
symbols and numbers, but 
which cannot be used in arith- 
metic operations. 

VARIABLE. Data that can be 
changed by you or the com- 
puter during program run. 


CONTROL | 


e SHORTCUTS 
@ ww a 


INPUT ... [CTL }[T ] 
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CHAPTER 3 


“CASSETTE 
COMMANDS” 


(OSy:\V/ SO BO7.\B) 





You are reaching the point where 


you may want to save the pro- 
grams you write. Normally, when 
you press or turn 
Aquarius off, your program in 
RAM is erased. But Aquarius | 
allows you to save programs on 
magnetic cassette tape, then 
load those programs into 
memory when you want to run 
them again. 


Is your cassette recorder hooked 
up to your computer? If not, turn 
back to the Introduction Section, 
page 7, for hook-up instructions. 


CSAVE — Saving A 





Program On Cassette 


When you enter the CSAVE com- 
mand, the program currently in 
memory is recorded on cassette. 
Use the CSAVE command in |Im- 
mediate Mode in this way: 


1. Type CSAVE (or press 

[ CTL }[ A ]), followed by your 
PROGRAM NAME IN QUOTA- 
TION MARKS. Then press 


| RTN |. (Although your program 


name may be longer than six 
characters, Aquarius will only 
pay attention to the first six.) If 
you do not give Aquarius a pro- 
gram name, Aquarius will give 
you an MO Error message. 


2. Aquarius will respond with: 
Press < RECORD > 
Press RETURN key to start 


3. On most cassette recorders, 
begin recording by SIMUL- 
TANEOUSLY PRESSING BOTH 


THE ( RECORD ) AND THE 
KEYS. Then press the 
key on your computer. 


4. Wait while Aquarius records 
your program. While saving is 
taking place, you may hear the 
data transfer through your TV 
speaker, aS several short bursts 
of sound. When the program is 
saved, Aquarius will respond: 


Ok 
LJ 


5. Press the ( STOP ) key on the 


recorder. 








6. VERIFY that your program 
was correctly CSAVED, following 
the instructions on pages 3 and 4 
of this chapter. 


Once you CSAVE a program, it is 
Stored in two places — in RAM 
and on the cassette tape. To 
erase it from RAM, type NEW 
and press [ RTN J. When you try 
to LIST the program, you'll find 
that it is gone. 


Enfn§ GOOD HABITS 
xk When you save the 
xk first program ona 
cassette, set the counter on the 
recorder to O. O will be the start- 
ing point (also called the LOAD 
POINT) of your first program. 
Then as you add programs to the 
cassette, keep track of the load 
point of each new program. 


When you add a program to a 
cassette 
past the end of the last program 
on tape before you 
your new program. Watch the in- 


dex counter on your recorder 
and separate programs by at 





least 2 numbers on the index 
counter. 


KEEP A LOG for each cassette. 
Note the NAME and LOAD 
POINT of each program on a 
cassette. 


USE THE RIGHT KIND OF TAPE. 
High-quality, low noise recording 
tape (no jonger than 60 minutes) 
will give the best results. 





ADJUSTING VOLUME 


Programs are saved on cassette 
in a series of low- and high- 
pitched squeaks. When you use 
cassette recorders that allow you 
to set the volume, you must ad- 
just the volume. It must be loud 
enough so that Aquarius can 
understand what is being re- 
corded. It must not be too loud, 
however, or distortion may occur. 


The proper volume adjustment 
varies from recorder to recorder. 
To set the volume on your 
recorder, try saving a short pro- 
gram a number of times. Each 
time you save the program, 





VERIFY it, following the 
instructions on page 4 of this 
chapter. If the program does not 
verify, adjust the volume and try 
again. 


When you find the correct 
volume setting, make a note of it. 
Then you will always be able to 
make the proper volume adjust- 
ment after using the recorder for 
other purposes. 


Moy\b)i le: 





PROGRAMS 


To reverse the CSAVE process 
and copy the program from the 
cassette tape to RAM, use the 
CLOAD command in Immediate 
Mode. 


1. 
Or key on your 

recorder to position the tape at 
the load point for the program. 


2. Type CLOAD (or press 
CTL }{ Z |) followed by the 
PROGRAM NAME IN QUOTA- 


SSSseSseeeeseseseseeseseseeseseeeseesege 
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TION MARKS. Then press 

{ RTN ]. (If you do not enter a 
program name, Aquarius will load 
the first program it finds.) 


3. Aquarius” will respond with: 
Press < PLAY > 
Press RETURN key to start 


4. In practice, it is better to press 
the key on your computer 
first. Then press the key 
on your recorder. If you reverse 


this process, you may miss your 
load point. 


5. Aquarius searches the tape for 
the program name you entered. 
When it finds the program, it 
prints: Found: (your program 
name) 


6. After it finds your program, 
Aquarius automatically loads it 
into RAM. When loading is com- 
pleted, Aquarius displays: 


Ok 
oo 


7. Press the ( STOP ) key on your 
recorder. Your program is now 
stored in RAM, ready for you to 


RUN or LIST. (Of course, it is still 
stored on cassette also.) 


8. VERIFY that the program in 
RAM matches the program on 
cassette, following the directions 
on page 4 of this chapter. 





BY THE WAY 

The CLOAD command 
automatically gives a 
NEW command also, which 
erases everything stored in RAM. 








SKIPPING OVER PROGRAMS 


lf the tape is not positioned at 
the correct load point for a pro- 
gram, Aquarius will search the 
entire tape, load point by load 
point until it finds the program 
you have named. Each time it 
reaches a program other than 
the one you have named, it will 
stop and display these 
messages: 


Skip (program name) 
Press < PLAY > 
Press RETURN to start 





Aquarius displays the “Skip” 
message for each program it 
finds that does not match the 
program you named when you 
entered the CLOAD command. 
The ‘‘Skip’’ message is always 
followed by directions to press 

PLAY ) and the key. The 
recorder will continue running, so 
you do not need to press PLAY. 
YOU MUST PRESS 
EACH TIME, IN ORDER TO CON- 
TINUE SEARCHING. If you do 
not press RTN fast enough, you 
may miss the load point for the 
next program on tape. 


If you miss the load point for a 
program, rewind the cassette 
prior to the load point for the pro- 
gram, and press the key 


on your cassette recorder. 


When Aquarius finds the program 
you named, it will display this 
message: 


Found: (program name) 


It will then automatically load 
that program into RAM. When 
loading is complete, Aquarius will 
display the Ok prompt. 
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VERIFY — 


DID IT COPY? 





After saving or loading a pro- 
gram, you can VERIFY that the 
program on cassette matches 
the program in RAM. Follow 
these steps: 


1. ( REWIND ) the cassette to the 
load point for the program you 
just saved or loaded. 


2. TYPE CLOAD? followed by the 
PROGRAM NAME IN QUOTA- 
TION MARKS. Then press 
LRTN }. 


DON'T FORGET THE QUESTION 
MARK AFTER CLOAD! If you 
leave it off, Aquarius will think 
you gave the CLOAD command 
and erase everything stored in 
RAM (including your original pro- 
gram, if you have just CSAVED). 


3. Aquarius will respond: 
Press < PLAY > 
Press RETURN key to start 


4. In practice, it is better to press 
the key on your computer 
first. Then press the key 
on your recorder. If you reverse 
this process, you may miss your 
load point. If you miss the load 
point for your program, Aquarius 
wiil not find your program. 


REWIND ) and try again. 


5. When Aquarius finds your pro- 
gram, it will print: 


Found: (your program name) 


lf the program on cassette mat- 
ches the program in RAM, 





Aquarius will print: Ok. This 
means your program has verified 
and you can go on to the next 
command. 


6. If the program on cassette 
DOES NOT match the program 
in RAM, Aquarius will print: 


Bad 
Ok 


The Ok prompts you to enter the 
next command. It does not mean 
your program verified. Try saving 
or loading the program again. 
Then verify again. 
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SAVING AND 





LOADING ARRAYS 


You can save large blocks of 
data in ARRAYS on cassette. 
(Arrays are explained in Chapter 
9.) Then you can load this data 
into the program currently stored 
in RAM, into the memory block 
reserved by the program for that 
data. Saving and loading arrays 
is slightly different than saving 
and loading programs. Here is 
how to do it. 





A NOTE TO THE NOVICE: Until 
you understand and use arrays, 
you do not need to understand 
this section. Skip it, until you 
need it. 








To Save An Array 


The array must be a numeric ar- 
ray The array that you save 
must be dimensioned by the pro- 
gram of which it is a part. 


Example: 10 DIM A (100) 


In Immediate or Programmed 
Mode, save the data stored in 
your dimensioned array with the 
command CSAVE* followed by 
the array name (A in the example 
above). Do NOT put quotation 
marks around an array name. 


Example: 500 CSAVE* A 


When the CSAVE* command is 
executed, either when you press 
[ RTN | after typing the command 
or when that program statement 


is executed, Aquarius will tell you: 


Press < RECORD > 
Press RETURN key to start 


Press the ( RECORD ) key on 
FAN] 


your recorder, then the 

key on your computer. After sav- 
ing your array, Aquarius will 
display: Ok. 





Press the key on your 
recorder. Be sure to use the in- 
dex counter on your recorder to 
keep track of the load point and 
end point of your saved array. 


To replace an array with a new 
version, position the tape at the 
load point for the old version. Be 
aware that the new version may 
replace part of the next program 
or array, if the new version is 
significantly longer than the old 
version. | 


lf you want to save both old and 
new array data, dimension both 
an input array-and an output ar- 
ray, when writing your program. 
After loading array A from 
cassette, process the data in the 
array and save the results in ar- 


ray B on cassette. When the pro- 


gram has ended, your cassette 
contains both the original data 
and the revised data. 


Example: 10 DIM A (100) 
20 DIM B (100) 
30 CLOAD* A 


500 CSAVE* B 
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To Load An Array 


The CLOAD* command loads a 
numeric array into memory from 
cassette. 


You must DIMENSION an array 
before you can load it into 
memory. Once you dimension an 
array, you may load that array 
any number of times. Each time 
you enter the. CLOAD * com- 
mand, Aquarius erases the array 
currently in the memory block re- 
served for it by your program. 
(The size of the memory block in 
your program must match the 
size of the dimension you give 
the array.) Then, Aquarius reloads 
the array from cassette data. 


Notice that array names are NOT 
enclosed in quotation marks in 
the CLOAD * command. 


Before you enter the CLOAD* 
command, position the tape a lit- 
tle before the array load point. 
Aquarius Skips over arrays 
whose names do not match the 
name in the CLOAD* command. 
If you think that you have missed 
a load point, the tape 


and try again. 





CLOAD* Example 1: You load array C1 in Immediate Mode. 


DIM C1 (100) Dimension array C1. 

CLOAD* C1 Enter the CLOAD * command. 

Press < PLAY > Aquarius tells you to press the 

Press RETURN key to start key on your recorder 
and the key on your com- 
puter. 

PLAY Press the key, then 
IMMEDIATELY press { RTN J. Or 


press both keys together. 





Aquarius does not tell you when it finds the array or whether the array 


is being loaded into memory. It displays the Ok prompt AFTER the ar- 
ray has been loaded. Press the ( STOP ) key on your recorder. 


CLOAD* Example 2: You load array A in Programmed Mode. Your ar- 
ray is too large to be loaded in a single step. To use the data in the ar- 
ray, you previously saved it in smaller groups. Each group of data has 
the same array name. 


Notice that you dimension array A BEFORE loading the data for the ar- 
ray. After loading the array, you print the data in the array, and load 
another portion of the array. Each time you load array A, you replace 
the previous contents of the array in memory. 
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To effectively use this approach 
to loading array data, you must 
accurately position the cassette 
at the load point for each array. 





10 DIM A (100) 
20 CLOAD* A 
30 FOR |=1 TO 100 
40 PRINT A (I); 
90 NEXT | 
60 GOTO 20 
BY THE WAY 


The CLOAD* com- 
amu = (TIAN iS NOT used to 
VERIFY whether an array in 
memory matches an array on 
cassette. 
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CSAVE...[CTL }[A] 
CLOAD...[CTL }{ Z ] 


COMPUTER TALK 
SO we 
as am 


LOAD POINT. The start point 
for a program loaded on 
cassette tape. 
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CHAPTER 4 


BRANCHING 
OUT 


(GOTO, IF... THEN and 
arels) 
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So far the programs we have 
written have been like the main 
street of a town. Aquarius” goes 
down this street, step by step, 
stopping along the way to carry 
out any instructions that it finds. 


But Aquarius can do a lot more 
than march straight down the 
Street. It can skip ahead or jump 
back along that street...or go to 
another street altogether. It can 
also travel in circles. 


All of these abilities are very use- 
ful to us In programming and 
they all come under the genera! 
heading of BRANCHING. When- 
ever you tell Aquarius to stop go- 
ing straight down the street and 
go somewhere else, you are giv- 
ing ita BRANCHING instruction. 
When you tell Aquarius to travel 
in circles, you are giving it a 
special kind of branching instruc- 
tion, called a LOOPING instruc- 
tion. 


There are two ways to set up 
any branching instruction (includ- 
ing looping instructions). You can 
write an UNCONDITIONAL 
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BRANCHING instruction, which 
is like saying to Aquarius, ‘‘Go 


here, no matter what other condi- 


tions exist in my program.”’ Or 
you can write a CONDITIONAL 
BRANCHING instruction, which 
says to Aquarius, ‘‘Wait a 
minute. First, check and see if a 
certain condition exists in my 
program. If it does, go one place. 
If it doesn’t, go another place.” 


In this chapter, we will learn how 
to use two commands that will 
let us write branching instruc- 
tions. They are GOTO and IF... 
THEN. 


GOTO — THE 


ONE-WAY TICKET 





GOTO is a BASIC command that 
does exactly what it sounds like. 
It tells Aquarius to GO TO some 
other line. It doesn't tell Aquarius 


to come back — GOTO is a one: 


way ticket. Because Aquarius 
has to know which line to go to, 
the command GOTO is followed 
by a line number. 











EXAMPLE: GOTO 80 


This tells Aquarius™ to go to Line 
80 in the program. 


GOTO can be used to send 
Aquarius either forward or back- 
ward in a program. One of its 
most common uses is to send 
Aquarius BACK in a program, to 
repeat a group of statements 
over. This is called LOOPING 
and the group of repeated state- 
ments is called the LOOP. Add 
line 60 below to your ‘Getting 
Acquaintid’’ program, to see 
how it works. The program will 
look like this: 


10 INPUT ‘‘Hi, what’s your name’’;NA$ 

20 ? ‘‘How old are you, nm ’';NA$; 

30 INPUT age 

40 LET DAYS=age* 365 

50 ? ‘‘That’s at least’’;DAYS;”’ 
rmdays!”’ 

60 GOTO 10 


When you run this program, 
Aquarius will wait after each 
question until you type in a 


response and press | RTN |. 


Then it will print the number of 


days in your age, go back to the 
Start of the program and run it 
again...and again. Boring, huh? 


This little program is an example 
of a PERPETUAL LOOP TO 
STOP IT PRESS [CTL }{C ]. 
There are not many instances 
where a perpetual loop is desir- 
able. You might use it to create 
a kaleidoscope...or to drive 
someone crazy with repeating 
tones. But more often, you will 





want to put a limit on your loops. 
One way to limit a loop is with 
CONDITIONAL branching. 


A perpetual loop is an example 
of UNCONDITIONAL branching. 
lf we make our branching condi- 
tional, we give ourselves a way 
out of the perpetual loop. For this 
we use a two-part statement, IF... 
THEN. 
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IF...THEN 


(THE TRUTH 
DETECTOR) 





IF...THEN lets Aquarius 
EVALUATE AN EXPRESSION and 
CHOOSE A COURSE OF AC- 
TION, depending on whether the 
expression is true or false. 


Example: 
IF X = 10 THEN GOTO 100 


X = 10 is the expression GOTO 
100 is the course of action. 


Aquarius checks the value of X. 
If it finds that X does equal 10, it 
evaluates the expression as 
TRUE and executes the state- 
ment following the word THEN. 
In the example above, that state- 
ment is GOTO 100. (The word 
GOTO is usually omitted because 
it is understood. Example: IF X 
= 10 THEN 100.) However, you 
can use any valid statement. 
Example: IF X = 10 THEN 
PRINT “HELLO”. 





lf Aquarius evaluates the expression as FALSE, it branches to the next 
LINE of the program (NOT the next statement on the same line). 


Add lines 60-90 below to your ‘‘Getting Acquainted” program, to see 
how the IF...THEN statement works. 





PROGRAM EXPLANATION 
10 INPUT ‘‘Hi, what’s your name?’’; NA$ 


20 ? ‘‘How old are you,rm’’;NA$; 

30 INPUT age 

40 LET DAYS = age*365 

50 ? ‘‘That’s at least’’;DAYS;’’days!’’ 

60 ? ‘‘Anyone else (y = yes)?’’ New line 60 calls for the letter y 
to be typed if the answer is yes. 


70 INPUT P$ Branches back to line 10 IF P$ 

80 IF P$ = ‘‘y’’ THEN 10 = “y’’ Quotes around define it 
as a literal, rather than a 
variable. 

90 END If P$ is any literal other than “y”’ 


the program ends. 


The expression that Aquarius™ evaluates in an IF...THEN instruction 
may be a NUMBER OR ARITHMETIC EXPRESSION. If it is, Aquarius 
looks at the TRUTH VALUE of the number or expression. If the value is 
0, the expression is judged FALSE. /f it is NOT 0, it is judged TRUE. 
You can file this information away for future reference, because it is 
not the kind of expression that you will normally use. 





CHAPTER 4 








The evaluated expression is 
usually a RELATIONAL or 
LOGICAL EXPRESSION. 


RELATIONAL 
AND LOGICAL 


EXPRESSIONS! 
WHAT ARE THEY? 





Nothing to get scared about. Just 
take a moment to get familiar 
with them. 


RELATIONAL EXPRESSIONS 
compare values and show the 
relationship between them. Call 
one value X and the other value 
Y. These are the relationships 
that can exist between X and Y: 


X equals Y (X = Y)t 
X is greater than Y (X > Y)t 
X is less than Y (X < Y)t 


t THE SHORTHAND EXPRESSION 
Equals (=), greater than (> ) 


and less than (< ) are 
RELATIONAL OPERATORS. Rela- 


tional operators can be com- 
bined, like this: 


X is less than or greater than Y 
(X < > Y). Also means X does 
NOT equal Y. 


X is equal to or greater than Y (X 
> = Y). Also means X is NOT 
less than Y. 


X is equal to or less than Y (X < 
= Y). Also means X is NOT 
greater than Y. 


These are the keys you use to 
type relational operators. 


LESS THAN 

GREATER THAN 

[ = ] cquais 

and LESS THAN OR 


GREATER THAN 


and [ = ] Less THAN OR 


EQUAL TO 


and [ = ] GREATER THAN OR 


EQUAL TO 





lf Aquarius has to make more 
than one comparison in an ex- 
pression, it makes the com- 
parisons in order, from left to 
right. 


Example: |f Aquarius reads 

X = Y> Z, it will first look at 
whether X and Y are equal, then 
whether X and Y are both 
greater than Z. 


lf Aquarius has both arithmetic 
and relational operations to deal 
with in the Same expression, it 


will perform the arithmetic opera- 


tions first and evaluate the rela- 
tionship second. Example: A + 
B=C+4+D. 


LOGICAL EXPRESSIONS 


If more than one relational ex- 
pression has to be evaluated as 
true or false, they are combined 
in a LOGICAL expression by the 
words AND or OR. 


IFA>BORC =D 


Means if EITHER relational ex- 


pression is true, the entire 
logical expression is true. OR 
is the “logical operator’. 
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IFA>BANDC = D 
Means if BOTH relational ex- 
pressions are true, the entire 
logical expression is true. AND 
is the “logical operator’. 


The word NOT is also a logical 
operator. It is used to reverse the 
true/false value of a constant, 
variable or the result of evaluat- 
ing a relational expression. Ex- 
ample: NOTA. 


The order in which Aquarius 
checks logical operators is: 


NOT 
AND 
OR 


lf Aquarius” runs across a COM- 
BINATION of arithmetic, rela- 
tional AND logical expressions, it 
evaluates them in that order. 





END / STOP 


Notice the new use of an END 
Statement in our program. END 
is just a way of telling Aquarius 


to halt execution of a program. If 
there is no branching in a pro- 
gram, the END statement is un- 
necessary. With more compli- 
cated programs, however, 
Aquarius doesn't have an auto- 
matic stopping point. So we add 





in the END statement to ‘‘flag it 
down’. The END statement does 
not always appear on the last 
line of a program. It is, however, 
the last statement executed in a 
program. Once a program is 
ENDed, it cannot be CONTinued. 
It can only be RUN again, from 
the beginning. 


Like END, the STOP statement is 
a way of halting program execu- 
tion. It can be placed anywhere 
in a program. When Aquarius en- 
counters a STOP statement, it 





displays a ‘Break in...’ message 
indicating the last program line 

that it executed. You can resume 
program execution after a STOP 
Statement, using the CONT com- 


_mand in Immediate Mode...un- 


less Aquarius encounters an er- 
ror in Immediate Mode during 
the pause. 





COMPUTER TALK 





BRANCH. The decision point in a 
program, where the computer 
‘‘decides”’ on an alternate 
course to take. 


LOGICAL EXPRESSION. An ex- 
pression that combines two or 
more arithmetic or relational 
expressions, using the words 
AND, OR or NOT. 


LOGICAL OPERATOR. One of the 
words AND, OR or NOT, used 
to combine the elements of a 
logical expression. 





oe 
ait 
a ie 
<= 
a OR 
O 








LOOP. A group of repeated state- 


ments in a program. 


PERPETUAL LOOP. A loop that 
repeats endlessly, unless the 
program is halted manually. 


RELATIONAL EXPRESSION. An 
expression that compares 
values. 


RELATIONAL OPERATORS. The 
symbols =, >,<,<>,>= 
and <= used to compare 
values in a relational 
expression. 
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GOTO..[CTL }{5 ] 
IF..[CTL }[3 ] 
THEN..[ CTL }{4 ] 














= 


ff 2A 6S 


fs 


’ 
c 





| 


J 


SESE SEE FT 


J 


CHAPTER 5 


“LOOPS THAT 
COUNT” 


(FOR...NEXT Loops 
“Digital Clock’) 





In Chapter 4 we learned how to 
use the GOTO statement to 
create perpetual loops. We also 
learned that perpetual loops are 
not very useful. In general, for a 
loop to be really useful, it needs 
to be limited by: 


e the CONDITIONS under 
which it will repeat; or 

e the NUMBER OF TIMES it 
will repeat. 


THE LONG WAY 





AROUND 


The program below is an exam- 


ple of a GOTO loop that counts. 


PROGRAM 


EY a ate 5 


We have seen how to limit the 
conditions under which a loop 
will repeat, using the IF...THEN 
Statement. In this chapter, we 
will see how to limit the number 
of times a loop will repeat. This, 
in turn, will open the door to one 
of our computer's more powerful 
abilities — the ability to COUNT. 


EXPLANATION 


The semi-colon tells Aquarius to 
print the numbers next to each 
other, instead of in a vertical 
column. 
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In this program we have a 
variable |. In line 10, we set the 
starting value of | to 0. This is 


called INITIALIZING the variable. 


It is not always necessary to in- 
itialize a variable whose starting 
value is to be 0, because the 
RUN command automatically 
sets all variables at 0. 


In line 20 we print the value 
Stored in the variable |. The first 
time through the loop, 0 is 
printed. 


In line 30 we have a (LET) state- 
ment that at first glance may 
look like nonsense. Mathematic- 
ally, it is nonsense. But in BASIC, 
the = sign in a LET statement 
does not mean ‘‘equals”’. It 
means | ‘‘is to be replaced by”’ | 
+ 2. When Aquarius © sees this 
statement, it takes the current 
value of |, adds 2 to it and stores 
this new value under the label |. 
This is our COUNTER. It causes 
the value of | to be ‘‘INCRE- 
MENTED" by 2 each time the 








statement is executed. 


Finally, in line 40 we send 
Aquarius back to the PRINT 
Statement in line 20, to print the 
new value of |. 


If you try this little program, be 
ready to use rome to stop 
the program. Otherwise, Aquarius 
will count from 0 to 1E + 38. 


(That's scientific notation for 1 
followed by 38 zeroes.) 


ADDING IF...THEN 


So far we have a loop that 
counts, but for all practical pur- 
poses it’s still a perpetual loop. 
The reason is that we have given 
our counter a starting point, but 
we haven't given it a stopping 
point. (1E + 38 hardly qualifies as 
a stopping point.) 


So we'll add an IF... THEN state- 
ment to set an ending point. 
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1.1=9 lf you RUN this program now, 
20 PRINT |: Aquarius ™ will print the even 
numbers from 0 to 98, then stop. 


Notice that the numbers are 

30 |} =1+2 separated by a space. Aquarius 
40 IF |< 100 THEN 20 Tells Aquarius to check the value always prints positive numbers 

of |. As long as | is less than (< ) with a leading blank. 

100 the expression is true and 

the statement (GOTO) 20 is ex- 

ecuted. When | reaches 100, the 

expression is no longer true, so 

Aquarius proceeds to the next 

line, 50, which contains the 








STOP statement. 
50 STOP 
PROGRAM EXPLANATION 
FOR...NEXT LOOPS | 10 FOR | = | to 100 The FOR statement sets a 
, = variable | whose values range 
from 7 to 100. This is called an 
The companion FOR and NEXT ; 
statements do the same thing as Index Variable. It is our counter. 
our counting GOTO loop, but . 
they do it more efficiently. 20 PRINT |: oS prints the current value 
30 NEXT | The NEXT statement marks the 


end of the loop and signals the 
next repetition of the loop, until 


the ending value of | is executed. 
CONTINUED ON NEXT PAGE 
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40 END 


When | = 101, Aquarius leaves 
the loop and proceeds to the 
next line. 





The FOR statement can also 
contain variables. For example: 


10 INPUT ‘‘Enter a number (3-15)'’:N 


You enter a number from 3 to 15 
(say 5) during program run. This 
number is stored as variable N. 


20 FOR |=1 TON: PRINT |: 

When Aquarius sees the variable 
N, it replaces it with the value 
you entered, Line 20 becomes 
FOR {=7 TO SHIN... 


30 NEXT | 


FOR...NEXT COUNTDOWN 
(TIME DELAY LOOPS) 


Computers are fast...sometimes 
too fast! Computers can print a 
string of numbers so fast it 
makes your eyes ache to watch 
it! 


You can use the FOR and NEXT 
Statements in their simplest form, 
to set up a time delay loop and 
slow Aquarius down. A time 
delay loop tells Aquarius to count 
to some number before it exe- 
cutes the next command. (Sort of 
like counting to 10 before you 
blow your top.) 


A time delay loop looks like this: 
10 FORT = 1 10-500 
20 NEXT T 


You can use any numeric 


variable to define a time loop. 
We picked T for Time. 





COMBINING STATEMENTS — 
THE SPACE SAVER 


You can combine statements on 
one line, as long as you separate 
them with a COLON. 

Example: 


FOR J = 1 to 500:NEXT T 


FOR | = 1 to 100:PRINT | ;:NEXT | 





ONE STEP AT ATIME 


When Aquarius executes a FOR.. 
NEXT loop, it automatically in- 
creases (‘‘INCREMENTS’’) the 
variable by 1 each time the loop 
is repeated. This ‘increment’ of 
1 is called the DEFAULT incre- 
ment. 


You can select a different incre- 
ment than 1, using the keyword 
STEP with the increment you 
want. 
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Example: 


FOR 1 = 510 100STEP 5 

sets an index variable whose 
values range from 5 to 100 and 
are incremented by 5 each time 
the loop is executed. When the 
value of | is GREATER than 100, 
Aquarius breaks out of the loop. 


FOR | = 100 to5 STEP —5 
sets an index variable whose 
values range from 100 to 5 and 
are decremented (decreased) by 
5 each time the loop is executed. 
When the value of | is LESS than 
5, Aquarius breaks out of the 
loop. 





BY THE WAY 
Whenever we speak 
amu «8 Of a DEFAULT value 
or operation, we mean a value or 
operation that Aquarius 
automatically assumes unless 
you specify some other value or 
operation. 

















THE NESTING 
INSTINCT 





When a FOR...NEXT loop is used within another FOR...NEXT loop, the 
loops are said to be NESTED. Nested loops are useful when you want 
to repeat one loop several times for EACH time you repeat another 
loop. 








PROGRAM EXPLANATION 

10 FOR! = 1to3 Aquarius begins the outside loop, 

20 PRINT ‘‘Hello’’ prints ‘“‘Hello”’, 

30 FOR K = 1 to3 then begins the inside loop. It ex- 
ecutes the inside loop 3 times, 

40 PRINT ‘‘Aquarius’’ printing ‘‘Aquarius’’ 3 times. 

50 NEXT K 

60 NEXT | After the inside loop is executed 
3 times, the next outside loop is 
executed. 

70 END When the 3rd outside loop is 


completed, the program ends. 
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When you RUN this program, 
your screen should look like this: 


Hello 

Aquarius 
Aquarius 
Aquarius 


latiite) 

Aquarius 
Aquarius 
Aquarius 


Hello 
Aquarius 
Aquarius 
Aquarius 
Ok 

B 


KEY IDEAS 

WHEN LOOPS ARE 
NESTED, THE INNER- 
MOST LOOP IS EXECUTED 
THROUGH ITS COMPLETE 
RANGE OF VALUES BEFORE 
THE NEXT OUTSIDE LOOP IS 
REPEATED. 











Example: 
10 FOR A=1 10 4 
20 PRINT ‘‘A’; 
30 FOR B=1 705 
40 PRINT ‘‘B’ 
50 NEXT B 
60 NEXT A 


Aquarius prints: 
ABBBBBABBBBBABBBBBABBBBB 


In other words, for each repeti- 
tion of an outside loop, the 
nested loop is executed through 
its entire range of values. In the 
example above, you cannot 
switch the order of lines 50 and 
60. B is the nested loop and 
must be executed first. 





“DIGITAL CLOCK” — 


OUR FIRST “REAL” 
PROGRAM 





So far you’ve seen how various 
commands work in simple pro- 
grams that do little more than 
print messages. Perhaps you're 
getting eager to try a more 
challenging program. ‘Digital 
Clock’ will enable you to use 
your new programming skills to 
build a real though simple digital 
clock. 


Rather than just giving you in the 
program to copy, we will develop 
it together, step by step, so you 
can see the PROCESS of writing 
a program. 


But first, there is a new word 
that we need to examine. 


Oooonct 
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TAB 


Usually, when you tell Aquarius 
to PRINT data, it starts at the left 
margin, in column 1. Aquarius 
leaves columns 0 and 39 blank. 
lf you want Aquarius to start 
printing at some other point on 
the screen, use the TAB 
function.t 


t FUNCTIONS ARE EXPLAINED IN DETAIL IN 
CHAPTER 10. FOR NOW, JUST USE THE 
TAB FUNCTION. 


TAB FUNCTION 


TAB(15) 


? TAB(15) ‘‘HELLO”’ 
? TAB(10) ‘‘HELLO’’ TAB(20) 
“AQUARIUS” 


? TAB(10) ANS 


? TAB(35);‘‘AQUARIUS”’ 


? TAB(90) ‘‘HELLO”’ 


CONTINUED ON NEXT PAGE 





EXPLANATION 


This means start printing in col- 
umn 16. The first literal printed 
always appears in the NEXT 
COLUMN AFTER the one you 
specity. 


This tells Aquarius to print 
HELLO starting in column 16. 


This tells Aquarius to print 
HELLO starting in column 11 and 
to print AQUARIUS starting in 
column 21. 


This tells Aquarius to print the 
value stored in AN$, starting in 
column 117. | 


This causes AQU to.be printed at 
the end of one line and ARIUS to 
be printed at the start of the next 
line (because there are 38 posi- 
tions per line on which charac- 
ters can be printed). 


This causes HELLO to be printed 
Starting in column 15, 3 rows 
below the TAB instruction. 
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? TAB(14+38%*2) “HELLO” 


Another way of writing TAB(90). 
Here 74 is the column number 
that will cause data to be printed 
in the 15th column. 38 *2 adds 2 
rows of 38 columns each, drop- 
ping the final tab position down 
to the 3rd row. 








READY TO START 


PROGRAMMING 





Type in each statement as you 
see it. Read the accompanying 
explanation, So you understand 
what you are doing. The program 
Starts with the simplest step — 
setting up the screen format — 
then adds steps that increase in 
complexity. 





AN IMPORTANT REMINDER 
— YOU CAN STOP ANY TIME 
YOU LIKE. If you reach a point 
where nothing makes sense any- 
more (called OVERLOAD), just 
save what you've done so far 
and stop for a while. When you 
come back to the program, you'll 
have a fresh outlook. All pro- 
grammers experience overload. 
The smart ones recognize it as 
“quittin’ time”’. 
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“Digital Clock” 





PROGRAM 
? CHRS(11) 


? TAB(17) “'TIME”’ 
? TAB(17+38*4) “TIME” 





EXPLANATION 


In IMMEDIATE MODE, clear the 
screen. 


Test print your title, centered. 


Test print the title again, this time 
centered 5 rows down. 


Now let's write the first segment of the program. Our purpose will be to 
print the word TIME on the screen, allowing the person running the pro- 
gram to select the number of lines (from 0 to 6) between the top of the 
screen and the line on which the word is printed. 


10 ? ‘Enter the # of lines (0-6): "’ 
20 INPUT L 


30 T = L*38+17 


CONTINUED ON NEXT PAGE 


Aquarius waits for you to select a 
number of lines, then stores this 
number under the label L. 


This (LET) statement plugs the 
value we gave L into the formula 


for a tab position that centers the: 


word TIME on the line we chose. 
Aquarius does the arithmetic 
operation and stores the result 
under the label T (for TAB posi- 
tion). 











[|] CHAPTER5 © 

















40 ?CHR$(11) 


50 ? TAB(T) ‘‘TIME’’ 


This clears the screen. 


This prints TIME in the tab post- 
tion we chose. 








Now stop and RUN your pro- 
gram. When Aquarius” asks for a 
line number, type a number from 
O to 6, then press to 
make sure the program works. 
What happens if you input a 
number larger than 6? Try it. To 
avoid this problem, we add a 
conditional loop that sends us 
back to line 10 if the number we 
input is greater than 6. If our 
number is 6 or less, Aquarius 
continues with the next state- 
ment. 


PROGRAM 


25 IF L > 6 then 2CHRS(7):GOTO 10 


EXPLANATION 


Type this line, then list your pro- 
gram. Notice that Aquarius auto- 
matically inserts it between lines 
20 and 30. Note: CHRS(7) is a 
function that produces a SHORT 
BEEP. 





Now continue adding to your program. Print a sample hour and 
minutes, to see how they work on the screen. 





60 H=10:M=51 


(0 T=17 


80 ? TAB(T)H **:"' M 


H is our variable label for hours. 
M is our variable label for 
minutes. A COLON separates the 
two (LET) statements. 


We temporarily change the value 
of variable T (tab position). 


We print the values stored in 
variables H and M at tab position 
T. We print the literal ‘‘:’’ be- 
tween the values for hours & 
minutes. 
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Now RUN the program again. 
We have a time printed in hours 
and minutes, but things are a lit- 
tle lopsided. To correct the prob- 
lem, we change the value of T to 
move our HOURS:MINUTES dis- 
play more nearly under the word 
TIME. And we add a space 
before the literal colon, to bal- 
ance the space after it. (Aquarius 
prints all positive numbers with a 
space in front..remember?) Re- 
type lines 70 and 80. When you 
LIST the program, the new lines 
70 and 80 will replace the old 
lines 70 and 80. 


70° T=16 


80 ? TAB(T) H ‘nA’ M 





Next step — make the time variables (H and M) interactive. Use the 
INPUT command to allow the person running the program to enter the 
Starting time in hours and minutes. Here's where we see the value of 
incrementing line numbers by at least 10. We need to add statements 
between lines 60 and 70. 





60 ?°‘Enter HOUR (1-12):"’ Replace the old line 60 with one 
that will prompt you to enter the 
time in hours. 

62 INPUT H This stores number of hours you 
entered under label H. 

64 ? ‘Enter MINUTES (0-59):”’ This prompts you to enter 
minutes. 


This stores number of minutes 
you entered under label M. 


66 INPUT M 





Once again, we need to add conditional loops that will return to the 
‘prompt’ statements (lines 60 and 64) if the numbers entered are out 
of range for hours and minutes. 





63 IF H > 12 THEN ?CHR$(7): 
GOTO 60 


Rings bell and repeats ‘‘prompt’’ 
statement if value entered for H 
is greater than 12. 


67 IF M> 59 THEN ?CHR9$(7): 
GOTO 64 


Rings bell and repeats ‘‘prompt”’ 
Statement if value entered for M 
is greater than 59. 
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Now we have a program that lets us set a time and print it in a par- 
ticular place on the screen. That's interesting, but it's not a clock. A 
clock INCREMENTS minutes and hours — it COUNTS and shows the 
result of its counting. We can make our program count, too, by adding 
an index variable loop to increment minutes. 


90 M=M+1 Each time Aquarius executes this 
Statement, it adds 7 to the value 
of M. 

150 GOTO 80 This sends Aquarius back to line 


80, to print the value of H and 
the new value of M. 





RUN the program and see what 
you've got now. You've got a 
new problem to solve! Aquarius 


To fix this problem, we move the 
statements that clear the screen 
and set tab positions so they are 


prints each new time on a dif- 

ferent line! The word TIME dis- 
appears (scrolls) off the top of 

the screen. 





executed just before the hours 
and minutes are printed. Then 
we change line 150 so our 
‘‘clear screen”’ and ‘‘set tab” 
Statements are part of the GOTO 
loop. Here’s how: 


1. LIST the program. 

2. Re-type line 30 with new line 
number 72. 

3. Re-type line 40 with new line 
number 74. 

4, Re-type line 50 with new line 
number 76. 


5. Re-type line 70 with new line 
number 78. 

6. Erase old lines 30, 40, 50 and 
70 by typing each line number 
and pressing return. 

7. Re-type line 150 to read GOTO 
iz. 


Your program should now look 
like this: 


10 ? ‘‘Enter # of lines (0-6):’’ 

20 INPUT L 

25 IF L>6 THEN ? CHR$(7): 
GOTO 10 

60 ? ‘‘Enter HOUR (1-12):”’ 

62 INPUT H 

63 IF H > 12 THEN ? CHR$(7): 
GOTO 60 

64 ? ‘‘Enter MINUTES (1-59):”’ 

66 INPUT M 

67 IF M> 59 THEN ? CHR$(7): 
GOTO 64 

72 T = L*384+17 

74 ? CHR$(11) 

76 ? TAB(T)'‘TIME’’ 

18 T=16 

80 ? TAB(T) H''A:''M 

90 M=M+1 

150 GOTO 72 
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Now our program is beginning to 
LOOK like a clock, but it doesn’t 
seem to know that there are only 
59 minutes in an hour. Who ever 
heard of 10:135 as a time? We 
need statements that will incre- 
ment the hour when the minutes 
exceed 59 and reset the minutes 
back to 0. Add these lines: 











110 IF M> 59 THEN H=H+1 Increments the value of H when 
minutes increment past 59. 


120 IF M> 59 THEN M=0 Resets value of M to O when M 
increments past 59. 





Now we'll add a similar statement to reset the hour when it reaches 
and goes beyond 12. 





130 IF H > 12 THEN H=1. 





RUN the program. It is now beginning to resemble a clock, but we can 
still improve it. Let's add seconds. 





80 ? TAB(T)H “Al M UR S Change line 80 so it prints sec- 
onds as well as hours and 
minutes. 

85 S=S+1 Increment the seconds. 

90 IF S> 59 THEN M=M+1 Increments the value of M when 


seconds increment past 59. 


95 IF S > 59 THEN S=0 Resets value of S to 0 when S in- 


crements past 59. 
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RUN the program. Our “clock” 
now increments seconds, 
minutes and hours and prints the 
current value of each under the 
heading TIME. The last step we 
will complete is to set the timing 
on our clock. To do this, we add 
a simple time delay loop which 
we can adjust. 


140 FOR P=0 TO 850: NEXT P 


It takes Aquarius approximately 1 
second to count from 0 to 850 in 
this program. So this loop estab- 
lishes the duration of our second. 
This duration may need some ad- 
justment because the computer 
takes some time to process the 
statements. Adjust the duration 
by changing the range of P. 


LIST your complete program. It 
should look like this: 


10 PRINT ‘‘Enter # of lines (0-6):"’ 

20 INPUT 4. 

25 IF L> THEN PRINT CHR$(7): 
GOTO 10 

60 PRINT ‘‘Enter HOUR (1-12):"' 

62 INPUT H 

63 IF H > 12 THEN PRINT CHR$(7): 
GOTO 60 

64 PRINT ‘‘Enter MINUTES (1-59):”’ 

66 INPUT M 


67 IF M> 59 THEN PRINT CHR$(7): 


GOTO 64 
f2 t= bod + 7 
74 PRINT CHR$(11) 
76 PRINT TAB(T) ‘‘TIME’’ 
fo. 1 = 16 
80 PRINT TAB(T) H ‘tat’ M ‘RS 
85 S = S + 7 
90 IFS >59 THENM =M + 1 
95 IFS > 59 THEN S = 0 
110 IF M> 59 THEN H = H + 1 
120 IF M> 59 THEN M = 0 
130 IF H>12 THEN H = 1 
140 FOR P = 0 TO 850:NEXT P 
150 GOTO 72 





Now RUN the program. Is it a 
clock? It is! We'll build a fancier 
version in Chapter 11, but for 
now we DO have a clock. If you 
want your clock to stop, press 
reTC HC] The next time you 
RUN your program, you can 
reset your clock again. 


(P.S. Don’t forget to save this 
program if you have a cassette 
recorder hooked up to your com- 
puter.) 
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DECREMENT. To decrease. Also, 
the amount by which a value 
is decreased. 





DEFAULT. To automatically re- 
vert to a value or operation 
unless another is specified. 
Also, the value or operation 
that Aquarius automatically 
reverts to unless another is 
specified. 
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INCREMENT. To increase. Also, 
the amount by which a value 
is increased. 


INDEX VARIABLE. The variable 
in a FOR...NEXT loop that con- 
trols the number of times the 
loop repeats. 


NESTING. Inclusion of one loop 
or subroutine within another. 
(Nested subroutines are dis- 
cussed in Chapter 7.) 


TIME DELAY LOOP. The simplest 
form of FOR...NEXT loop, one 
that tells Aquarius to count to 
some number before execut- 
ing the next statement. 





CONTROL 
SHORTCUTS 





FOR...LCTL } [=] 
NEXT...[(CTL }-[ 2] 
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CHAPTER 6 


“A SPLASH OF 
COLOR” 


(PEEK and POKE, 
RAM matrix, PSET, 
PRESET and POINT). 





Everything you have typed so far has appeared as black characters on 
a light blue background. Aquarius’ has much more than this to offer in 
the way of color. In this chapter we will discover how to use the full 
range of color built into your Aquarius home computer. There is math 
involved in using color, but fortunately, YOU DON’T HAVE TO DO IT. 
ALL YOU HAVE TO DO IS PLUG NUMBERS INTO A COUPLE OF 
SIMPLE FORMULAS AND AQUARIUS WILL HANDLE THE MATH FOR 
YOU. So don't let the numbers put you off. Color makes a world of 
difference. (By the way, you will need a color TV set to get the most 
out of this chapter.) 








POKE A LITTE HERE, 
POKE A LITTLE THERE, 
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POKING AROUND 


POKE is a way of telling your 
computer to POKE something in- 
to a position on your TV screen. 
That something can be a CHAR- 
ACTER or a COLOR — FORE- 
GROUND and/or BACKGROUND 
color. 





POKE A CHARACTER 


You must give Aquarius 2 pieces 
of information: 


¢ WHICH CHARACTER to 
poke..given as a NUMBER. You 
get the number from the Charac- 
ter Code List starting on page 6 
of the Appendix. 


e WHERE on the TV screen to 
poke it. This is one of 960 
squares which the screen is 
divided into. You specify which 
square by a NUMBER. You get 
the number from the CHARAC- 
TER RAM MATRIX on page 4 of 
the Appendix. 


Example of a statement to POKE 
A CHARACTER: 


POKE 12328,65 


This tells Aquarius” to POKE the 
letter A into the Home Position 


on the TV screen. 65 is the Char- 


acter Code number for the letter 
A. 12328 is the number for the 
Home Position on the Character 
RAM Matrix. 


These numbers were simply 
plugged into a FORMULA. The 
FORMULA is the important thing 
to know, because you can look 
up the number for any character 
or any screen position on the 
lists. The FORMULA is: 


POKE (screen position), (charac- 
ter number) 


NOTE THE COMMA 
POKE A COLOR 


You must give Aquarius 3 pieces 
of information: 


¢ WHAT FOREGROUND COLOR 
to poke (if you want one). This is 


nS 


the color you give to whatever 
CHARACTER is printed in a par- 
ticular screen position. This color 
is given as a NUMBER. You get 
the number from the Color Code 
List on page 3 of this chapter. 


e WHAT BACKGROUND COLOR 
to poke (if you want one). This is 
the color of the screen itself ina 
particular position. This color is 
also given as a NUMBER, which 
you get from the Color Code List 
on page 3. 


e WHERE on the screen to poke 
these colors. This is one of 960 
squares which the screen is 
divided into. You specify which 
square by a NUMBER, which you 
get from the COLOR RAM 
MATRIX on page 5 of the Appen- 
dix. 


Example of a statement to POKE 
A COLOR: 


POKE 13352,5 * 16 + 3 


NOTE THE COMMA 
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This tells Aquarius ™ to POKE the 
FOREGROUND COLOR, VIOLET 
and the BACKGROUND COLOR, 
YELLOW into the HOME POSI- 
TION. 13352 is the number for 
the Home Position on the COL- 
OR RAM MATRIX. 5 is the 
number for violet. 3 is the 
number for yellow. 


These numbers were PLUGGED 
INTO A FORMULA. The FOR: 
MULA is what you need to know 
to plug ANY color into ANY 
screen position. (You can always 
look the number up.) The FOR- 
MULA IS: 


POKE (screen position), (fore- 
ground color) * 16 + 
(background color) 


lf you don't specify a foreground 
color, you will get BLACK. 


If you don't specify a background 
color, you will get LIGHT BLUE- 
GREEN. 


POKE BOTH CHARACTER 
AND COLOR 


lf you want to POKE BOTH a 
character and color into the 
Same screen position, you will 
need to use TWO POKE state- 
ments — one for the character 
and one for the color. Example.. 
To POKE a RED letter A into a 


DARK BLUE BACKGROUND in 
the HOME POSITION, use these 
two statements: 


POKE 12328,65 
POKE 13352, 1 * 16 + 11 (1 is 


the color code for Red and 11 is 
the color code for dark blue.) 


SELLS pa 20020074 a IN SCT 


COLOR CODE LISTt+ 


COLOR CODE 
Black............0........ 0 
FIO 6 Ge aoeee be Se ev eee ee es 1 
Green.................... 2 
Yellow........2.......0.... 2 
Blue..........02..0 0.00.4, 4 
Violet... 0.0. 5 
Light Blue-Green............ 6 
White... 00 .000020020200.0.. 7 


tCOLORS MAY VARY FROM TV SET TO TV SET. 





COLOR CODE 
Light Gray... 0... 8 
Blue-Green.......0........ 9 
Magenta................. 10 
Dark Blue................ 11 
Light Yellow............... 12 
Light Green............... 13 
Orange.................. 14 
Dark Gray................ 15 
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CHARACTER RAM 


MATRIX / COLOR 
RAM MATRIX 





Let's look at your television 
screen again. 


Aquarius” divides your TV screen 
into 24 rows and 40 columns. 
When you type a program, you 
can type in 38 of the 40 col- 


umns. But ALL 40 COLUMNS 
can contain a color or character, 
when a program is run, if you 
use the POKE statement. 


Because computers start with 0 
when they number things, ROWS 
are numbered 0 to 23 and COL- 
UMNS are numbered 0 to 39. 
Row 0, Column 0 is the HOME 
POSITION. 


There are 960 possible positions 
on the screen where Aquarius 
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can print a color and/or charac- 
ter. In order to keep track of all 
these screen positions, Aquarius 
Stores 2 ‘‘grids’”’ in its memory. 
One grid is for color; the other is 
for characters. 


EACH POSITION ON THE COL- 
OR GRID HAS A NUMBER 
CODE. EACH POSITION ON THE 
CHARACTER GRID HAS A DIF- 
FERENT NUMBER CODE. The 
grids are related. The difference 
between number codes for cor- 
responding positions on the two 
grids is ALWAYS 1024. (Add 
1024 to any character code 
number and you have the cor- 
responding color code number.) 


Because Aquarius stores these 
grids in RAM, they are called the 
COLOR RAM MATRIX and the 
CHARACTER RAM MATRIX. You 
will find the Color RAM Matrix on 
page 5 of the Appendix. The 
Character RAM Matrix is on page 
4 of the Appendix. 
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DETAILS — 
NUMBER 


RELATIONSHIPS 
ON THE MATRIX 





HOME POSITION 





1. HOME POSITION on the Char- 
acter RAM Matrix — 12328. 


2. Move 1 COLUMN right — add 1. 


3. Move 1 ROW down — add 40. 


4. Difference between corre- 
sponding positions on Character 
RAM Matrix and Color RAM 
Matrix — 1024. Home position 
on Color RAM Matrix = 

12328 + 1024. 





Let's take a look at the entire range of colors which is available to you. 
Enter and RUN this program: 


NEW This clears the memory. 


10 PRINT CHR$(11) This clears the screen when you 
RUN the program. 


20 CS=12328 + 1024 This stores the home position of 
the Color RAM Matrix in the vari- 
able CS. Colors will be displayed 
Starting from the home position 
on the screen. 


30 FOR |=0 TO 15 Loop gives the variable | a range 
of 16 values (0-15),-which will be 
used to set color codes and to 
select screen positions that ad- 
vance 7 column right each time 
the loop is executed. 


40 POKE CS +1,| CS +/ gives the current position 
on the Color RAM Matrix into 
which the current value of | is to 
be POKED. 


When |=0, the color Black (code 
Q) is poked into the home posi- 
tion (CS + 0). When | = 1, the col- 
or Red is poked into the next col- 
umn right. And so on, up to 15. 


CONTINUED ON NEXT PAGE 
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50 NEXT | Ends the loop and signals the 
next loop repetition, until the end- 
ing value of | is reached. 





When you RUN this program, all 16 colors are displayed in a row. 
Depending on how your TV set is tuned, the colors displayed may vary. 
Tune your TV set to suit your color preferences. 





To see the color range displayed in 2 rows of 8 colors each, enter and 
RUN this variation of the last program. 


PROGRAM EXPLANATION 

NEW Clear the memory. 

10 PRINT CHR$(11) Clear the screen. 

20 CS=12328 1024 Store home position of Color 
RAM Matrix in variable CS. 

30 N=15 Give a value of 15 to variable N. 

40 FOR!|=0 107 Establish a loop that will repeat 8 


times. Give variable | a range of 
8 values (0-7). 


50 POKE CS+1,I Establish the current position on 
Row 7 of the Color RAM Matrix 
CONTINUED ON NEXT PAGE (CS + 1) and insert the color code 
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corresponding to the current 
value of I. 


60 POKE CS+1+40,N Establish current position on Row | Co Qe 


2 of the Color RAM Matrix 

(CS +1+ 40) and insert the color 
code corresponding to the cur- 
rent value of N (starting at 

N= 75) 


70 N=N-1 , Decrement the value of N by 17, 
so that you can print color selec- 
tion codes 15-8 in descending 
order. | 


80 NEXT | End loop. Signal next loop repeti- 
| tion until ending value of | is 
reached. 


90 PRINT:PRINT Two PRINT statements used 
alone prints two blank lines, so 
the Ok prompt appears below 
our color bars. 


When you RUN this program, Aquarius will print 16 colors, one column 
at a time, switching back and forth between Row 1 and Row 2. 
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LA TRY THIS 
The program to the 
right will let you ex- 
periment with changing 
foreground and background col- 
ors on characters you print. 
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PROGRAM 
NEW 
10 ? CHRS(11) 


20 ? CHR$(13) 
30 ? ‘Choose foreground color (0-15)"’; 


40 INPUT A 


50 ? ‘‘Choose background color (0-15)"’: 


60 INPUT B 


70 ? ‘It's a beautiful world!”’ 
80 R=4 


90 D=A*16+B 


CONTINUED ON NEXT PAGE 





EXPLANATION 


Erases screen. 


Moves cursor down 7 row from 
fop. 


Tells Aquarius to wait while you 
enter a foreground color number. 


Stores that number under label A. 


Tells Aquarius to wait while you 
enter a background color 
number. Stores that number | 
under label B. 


Gives R a value of 2 (for Row 2). 


Computes the formula for fore- 
ground and background colors 
and stores the result under the 
label D. 
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100 FOR C=1 10 23 


110 POKE 12328+ 1024+R*40+C,D 


120 NEXT C 
125 FOR T=1 TO 2000: NEXT T 


130 GOTO 10 








Gives C a range of 23 values 
from 0 to 22 (number of column 
positions filled by sentence in 
line 70). 


Calculates position on the Color 
RAM Matrix for each column 
0-24 in Row 2 and pokes the 
foreground and background col- 
ors selected into those positions. 


Creates a time delay loop to slow 
down program execution. 


Starts the program over. Press 


| CTL }| C | to stop program 


execution. 
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PEEK 


PEEK is a handy ‘‘sidekick’’ to 
POKE. POKE says, ‘‘Insert this 
color or character into a particu- 
lar screen position.” 


PEEK asks, ‘‘What color or char- 
acter exists in a particular 
screen position?” + The com- 
puter responds to your PEEK 
question with the NUMBER 
CODE for the color or character 
in that screen position. (You can 
then look up the color or charac- 
ter that matches this number 
code, on the lists on pages 6 to 
10 of the Appendix.) 


Because Aquarius responds by 
PRINTING a number code, PEEK 
is used with a PRINT statement. 


Example: 


PRINT PEEK (12328) 


You can also write: 
10 C = PEEK (12328) 
20 PRINT C 


OF 
10 C = PEEK (12328 + 1024) 


20 PRINT C 





This tells Aquarius to print the 
number code for whatever char- 
acter is in the home position on 
the Character RAM Matrix. 


This sets a NUMERIC VARIABLE 
equal to the result of the PEEK 
command. The variable must be 
numeric since the result of the 
PEEK command is expressed as 
a number. In the second exam- 
ple, you look to see what COLOR 
occupies the home position on 
the Color RAM Matrix. 


tNOTE FOR ADVANCED PROGRAMMERS: As with POKE. this is a very specific use of PEEK. The 
genera! use of PEEK is to determine what value 1s stored at a particular memory location. 
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DRAWING LINES 





When you use the POKE state- 
ment to display colors on the 
screen, each screen position is 
calculated as: 


CS + (40* R)+C 
where: 


CS = the starting position on 
the Color RAM Matrix; 


R = the ROW in which the 
current position occurs; and 


C = the COLUMN in which 
the current position occurs. 





TO DRAW A VERTICAL LINE, create a loop in which the COLUMN 
number (C) is CONSTANT and the ROW number (R) VARIES. 


Example: 

NEW 

10 ? CHR$(11) 

20 CS = 12328 + 1024 
30 C = 10 


40 FORR = 010 23 


50 POKE CS +(40 * R)+C,1 


60 NEXT R 


You assign a constant value of 
10 to variable C (for Column). 
This will print the line in Column 
10. 


You assign a range of values 
(0-23) to variable R (for Row). 


Each time the program loops 
through this statement, a block 
of red (color code 1) is added to 


column 10 a row at a time. 
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TO DRAW HORIZONTAL LINES, create a loop in which the ROW 
number (R) is CONSTANT and the COLUMN number (C) VARIES. 


Example: 

NEW 

10 ? CHRS(11) 

20 CS = 12328 + 1024 


30 R = 10 


40 FORC = 010 39 


50 POKE CS +(40 * R)+C,1 


60 NEXT C 


You assign a constant value of 
10 to R (Row). This will print the 
line in Row 10. 


You assign a range of values 
(0-39) to variable C (Column). 


Each time the program loops 
through this statement, a block - 


of red is added to Row 10, a col- 


umn at a time. 
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TO DRAW DIAGONAL LINES, create a loop in which BOTH THE 
ROW NUMBER (R) AND THE COLUMN NUMBER (C) VARY. 


© If you INCREASE both R and C, the line will slant down to the RIGHT. 
e If you DECREASE both R and C, the line will slant up to the LEFT. 


e If you INCREASE R and DECREASE C, the line will slant down to the 
LEFT. 


© If you INCREASE C and DECREASE R, the line will slant up to the 
RIGHT. 


Example: 
NEW 
10 ? CHR$(11) 


20 Fee D R is set to O so that the line will 
Start in the home position. 


You calculate the starting posi- 
tion for CS. 


25 CS=12328 + 1024 


30 FOR C=0 TO 39 C is given a range of values that 
INCREASE from 0-39. 


Each time the program loops 
through this statement, a block 
of red is added to the next col- 
umn and row position. 


40 POKE CS +(40* R)+C,1 


CONTINUED ON NEXT PAGE 
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50 R = R+1 


60 IF R > 23 THEN 80 


70 NEXT C 
80 END 


You INCREASE R so that the line 
is drawn from left to right and 
from top to bottom. 


Each time you increase the value 
of R, you check R to make sure 
you don't draw the line off the 
screen. This statement gives you 
a way to branch out of the loop 
when you need to. 





THE FINE LINE 
(Using PSET, PRESET 


lalem ms OlINal 
Statements) 





PSET, PRESET and POINT allow 
you to divide the screen into a 
finer grid than 40 by 24. With 
these statements, you divide the 
screen into 80 columns and 72 
rows. That is, each character 
position on the screen is divided 
into 6 squares — 3 down and 2 
across. 


e PSET fills in a square. 
e PRESET erases a square. 


¢ POINT tells you whether a 
square is filled in. 


You use these statements with 
COORDINATES that specify the 
location of a square on the 80 x 
72 grid. 
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A 


e The first coordinate is the 
COLUMN. 


e The second coordinate is the 
ROW. 


Examples: 


e PSET(0,0) fills in the square in 
the upper left corner. 


e PSET(39,35) fills in the center 
square. 


e PRESET(39,35) erases the 
center square. 


e ? POINT(39,35) prints a 0 if the 
center square is NOT filled in 
or a 1 if the center square IS 
filled in. 


NOTICE THAT POINT IS USED 
AS PART OF A PRINT STATE- 
MENT. This permits the response 
to the POINT ‘‘question”’ to be 
printed on the screen. 





COLORING THE FINE LINE 


This simple program will draw a fine vertical line, then add in 
foreground and background color. 


NEW 
10 ? CHRS$(11) 
20 C=10 You set the column position for 


your vertical line. This will be 
drawn in the 10th column out of 


80. 

30 FOR R=0 T0 71 Loop sets a range of values for R 
which includes all row positions. 

40 PSET(C,R) You fill in each square in the col- 
umn, row by row. 

50 NEXT R 

60 FOR R=0 T0 23 You assign a new range of 
values to R. R now indicates a 
row on the 40 column by 24 row 
screen. 

70 FOR C=0 10 8 You assign a new range of 


values to C. C now indicates a 
column on the 40 column by 24 
row screen. 


CONTINUED ON NEXT PAGE 
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80 POKE 123284 1024+R*40+C,7* 


16+ 1 


90 NEXT C 


100 NEXT R 





You calculate positions on the 
Color RAM Matrix and poke 
WHITE foreground and RED 
background colors into those 


positions. 


Signal next repetition of loop C. 


Signal next repetition of loop R. 
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COLOR RAM MATRIX. The 24 by 
40 ‘‘memory grid’ on which 
Aquarius stores all screen 
positions in which COLOR can 
be inserted. 


CHARACTER RAM MATRIX. The 
24 by 40 ‘memory grid” on 
which Aquarius stores all 
screen positions in which 
CHARACTERS can be 
inserted. 


COLOR CODE. The number code 
- under which a color is stored 
in RAM. 





CHARACTER CODE. The number 
code under which a character 
is stored in RAM. 
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© CONTROL 


“@ SHORTCUTS 
Pane’ 


PSET...[[CTL }[ J ] 
PRESET...[CTL }{_K ] 
POINT...[CTL }(L J 
POKE...[CTL }[;@ ] 
PEEK...[.CTL }[:* ] 
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CHAPTER 7 


“SUBROUTINES 
/— THE ROUND: | 


TRIP TICKET” 


(GOSUB, RETURN, 
Nested Subroutines, 


REMARK, Computed | 


GOTO and GOSUB, 
~)0] 8) 1B) 





In Chapter 4 we compared a program to a town with a Main Street. (In 
a program, Main Street is called the MAIN ROUTINE.) We learned that 
we can send Aquarius” straight down Main Street, or make it jump 
from point to point using the GOTO statement. | 


But what happens when our town starts growing? We can add to both 
ends of Main Street, until the town is miles long and one street wide. 
But that is not an efficient way to build a town...or a program. 














When programs get lengthy, it 
tends to be because certain 
groups of statements are 
repeated at different points in the 
program. For example, if you 
POKE a color several times in a 
program, with other statements 
in between, you probably repeat 
an entire sequence of statements 
each time you poke the color. 


Rather than re-typing a group of 
statements each time you want 
to use it, Aquarius” lets you use 
the group as a SUBROUTINE. A 
subroutine is like a side street 
that branches off from Main 
Street, sending you back to Main 
Street when you reach the end. 


To get to a subroutine, use the 
GOSUB statement with the start- 
ing line number of the sub- 
routine. Example: GOSUB 100 


You can branch backwards or 
forwards, to any subroutine in a 
program at any time. When you 
branch to a subroutine, you 
speak of CALLING that sub- 
routine. 





The last statement in a sub- 
routine is always RETURN. This 
marks the end of the subroutine 
and sends Aquarius back to the 
main routine, TO THE STATE- 
MENT IMMEDIATELY FOLLOW- 
ING THE GOSUB STATEMENT 
FROM WHICH IT LEFT. 


REMARK — NOTES 





TO YOURSELF 


Experienced programmers start 
each subroutine with a REMARK 
statement. A REMARK statement 
is literally a note to yourself, 
identifying a subroutine or mark- 
ing a particular point in the 
program. 


A REMARK statement is NOT 
EXECUTED when the program is 
RUN. It only appears when you 
LIST or print your program. You 





still have to give a REMARK 
statement a line number, how- 
ever, and it still uses memory. 


To enter a REMARK statement, 
type REM followed by your 
‘‘note’’ (up to 72 characters 
long). Or press [CTL }-[ W ], then 
type your note. You do not have 
to enclose your note in quotation 
marks, since the statement is not 
executed. 


BY THE WAY 
=} You can use the 
oummees REMARK statement 
by itself, without a note, to insert 
nearly blank lines in your pro- 
gram list. This can make a pro- 
gram list easier to read. 
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The following program illustrates subroutine branching. In this program, 
Aquarius bounces a “‘ball’’ across the screen from side to side. Notice 
that making a character appear to move across the screen is nearly 
the same as drawing a line. You display and erase the character in one 
position before displaying it in the next position. 


PROGRAM 
NEW 


10 ? CHR$(11) 


20 PS=12328 


30 R=10 


40 FOR C=0 T0 39 


90 GOSUB 100 


CONTINUED ON NEXT PAGE 








EXPLANATION 
Clear memory. 


Clear the screen when the pro- 
gram is RUN. 


Store the starting position on the 
Character RAM Matrix in variable 


Give variable R a value of 10 (for 
Row 10). In this program you 
want the ‘‘ball’’ to bounce 
horizontally between the sides of 
the screen in Row 10. 


Use a loop to increment the col- 
umn number, stored as variable 
C, from column 0 to column 339. 


Call the subroutine that begins 
on line 100, to draw and erase 
the graphic. 
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60 NEXT C 


70 GOTO 40 


100 REM DRAW/ERASE GRAPHIC 


110 P=PS+(40*R)+C 


120 POKE P,135 


130 “PORE FP oe 


140 RETURN 


Continuation of the main routine. 


Indicate end of FOR..NEXT loop 
begun in line 40. 


After the FOR..NEXT loop has 
moved the ‘‘ball’’ through all 40 
columns, go back to statement 
40 and start all over again. 


Use a REMARK statement to 


identify the beginning of the sub- 


routine. 


Set up a formula that tells 
Aquarius the current position of 
the ball on the screen. The 
results of the formula are stored 
as variable P. 


Poke the code for a filled in cir- 
cle (the ball) into the current 
position (P) on the screen. See 
Character Codes, pages 6-10 in 
the Appendix. 


Erase the ball by poking the 


character code for a blank space 


in the same character position. 


Tell Aquarius to return to the 
statement following the GOSUB 
statement which called it. In this 
program, it returns to statement 
60. 





RUN your program. The ball will 
move so quickly that you will 
have to slow it down in order to 
see it. We will learn how to do 
this in the next section of this 
chapter. For now, press 
ror) to STOP the 


program. 
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NESTING 


SUBROUTINES 





Subroutines can not only branch 
off from the main routine, they 
can branch off from other sub- 
routines as well! This is called 


NESTING the subroutines. A pic- 


ture of nested subroutines might 
look like the diagram below: 


RETURN 





(SUBROUTINE 2) 


(SUBROUTINE 1) 


= 
L 

I 

I 

i 

I 
4 


In this diagram, Aquarius” bran- 
ches from the main routine to 
subroutine 1. Before it reaches 
the RETURN statement at the 
end of subroutine 1 it branches 
to subroutine 2. At the end of 
subroutine 2, Aquarius reaches 
its first RETURN statement. It 
returns to subroutine 1 and con- 





= oo teases RETURN | 


tinues on until it reaches the 
RETURN statement at the end of 
that subroutine. This RETURN 
Statement sends it back to the 
MAIN ROUTINE. 


WHEN AQUARIUS BRANCHES 
INTO NESTED SUBROUTINES, 
IT MUST RETRACE THE SAME 
PATH BACK TO THE MAIN 
ROUTINE. This is really just 
another way of saying that ANY 
RETURN statement ALWAYS 
sends Aquarius back to the state- 
ment FOLLOWING THE MOST 
RECENT GOSUB statement from 
which it branched. 





NOTE: Be careful in nesting sub- 
routines. It’s easy to accidentally 
change the value of a variable 
when more than one subroutine 
is nested. In the unlikely event 
that you try to nest more than 
100 levels of subroutines, 
Aquarius may stop program ex- 
ecution with an OM Error (Out of 
Memory) message. 
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GOOD HABITS 
KKK Avoid using a GOTO 
Statement to branch 
out of a subroutine. When you 
use GOTO in this manner, 
Aquarius forgets where to return, 
unless you use another GOTO 
Statement to branch back into 
the same subroutine again. It's 
complicated and best left alone. 








On the next page is a modifica- 
tion of our bouncing ball pro- 
gram, that uses a nested sub- 
routine to slow down the ball’s 
movement. Add these statements 
to the program on pages 3 and 

4 
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PROGRAM 
125 GOSUB 200 


200 REM DELAY LOOP 


210 FOR |=1 TO 50 


220 NEXT | 


230 RETURN 


EXPLANATION 


Branch from subroutine 100 to 
nested subroutine 200. 


Use a REMARK statement to 
identify the beginning of sub- 
routine 200. 


Create a TIME DELAY LOOP that 
counts up to 50 between esch 
movement of the ball. 


Indicate the end of the time 
delay loop. 


Tell Aquarius to return to the 
statement following the GOSUB 
statement in subroutine 100 
which called it. 


RUN your revised program with the nested subroutines. Notice how 
the time delay loop creates the illusion of a ball moving across the 
screen. Press [ CTL }{ C ] to stop the program. Change statement 210 
if you want to change the speed at which the ball moves. 





EARLY RETURNS 


You must have at least one RETURN statement in a subroutine, at the 
end. You can have MORE THAN ONE RETURN statement in a 





subroutine, however. For exam- 
ple, by combining a second 
RETURN statement with an 
IF..THEN statement, you can tell 
Aquarius” to leave the subroutine 
early and return, when the condi- 
tions of the IF..THEN statement 
OCCUTr. 


Add this statement to your 
bouncing ball program, to pre- 
vent the ball from moving past 
column 30. 


115 IF C>30 THEN RETURN 


This tells Aquarius to check the 
next position where the ball is to 
be displayed. If the next position 
is to the right of column 30 
(C>30) Aquarius returns to the 
main routine at statement 60. 


RUN your revised program. 


Press LCTL }| CJ to stop the 


program. : 





Note: Don't enter the NEW com- 
mand or turn Aquarius off. Either 
will erase this program and we 
are not finished with it yet. 
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COMPUTED GOTO 


AND GOSUB 





ON...GOTO 


A computed GOTO statement 
looks like this: 





10 ON S GOTO 100,150,500, 720 


NOTICE COMMAS BETWEEN NUMBERS. 





S is a NUMERIC VARIABLE 
whose value you assign else- 
where in the program. In this ex- 
ample, the value of S would be a 
number from 1 to 4. 


The numbers 100, 150, 500 and 
720 are LINE NUMBERS. Of 
course, Aquarius cannot go to all 
4 lines at once. These line num- 
bers give Aquarius a CHOICE of 
lines to go to. The value of S tells 
Aquarius which line to choose. 


lf S=1, GOTO 100 
(the 1st line number) 


lf S=2, GOTO 150 
(the 2nd line number) 


lf S=3, GOTO 500 
(the 3rd line number) 


If S=4, GOTO 720 
(the 4th line number) 


Wait a minute! Notice anything 
familiar here? Add the word 
THEN to the statements above. 


IF S=1 THEN GOTO 100 


One computed GOTO statement 
does the same job as several 

IF.. THEN statements...and uses a 
lot less memory space. 


ABOUT S (OR WHATEVER 
YOU WANT TO CALL IT) 


The NUMERIC VARIABLE that 
determines which line Aquarius 
will GOTO must follow a few 
rules: 


e |t must be a positive number. 
(Negative numbers will result in 
an error message.) 





e Its minimum value is 1. (A 
value of O will cause Aquarius to 
ignore the ON..GOTO statement.) 


e Its maximum value is the num- 
ber of line numbers listed in the 
ON..GOTO statement. 


310 S=7 
320 ON S GOTO 110,320,450 


These statements taken together 
make no sense, because there is 
no 7th line number given in state- 
ment 320. Aquarius would agree. 
It would ignore line 320 and pro- 
ceed onward to the next state- 
ment in the program. 


ON..GOSUB 


The computed GOSUB statement 
works in exactly the same way 
as the computed GOTO state- 
ment, except that the line num- 
bers given in the statement indi- 
cate the starting line of a sub- 
routine. Therefore, when 
Aquarius RETURNS from the 
subroutine, it returns to the state- 
ment immediately following the 
ON...GOSUB statement. 
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Let’s return to our bouncing ball 
program and tinker with it some 
more. We will create two new 
subroutines: one to move the ball 
from left to right and the other to 
move the ball from right to left. 
Each subroutine will set the 
value of S to either 1 or 2, so 
that Aquarius will branch to the 
other subroutine when it returns 
to the main routine. 


First LIST the program. Notice 
that all statements are printed in 
UPPER CASE, even if you 
entered them in lower case. This 
is the DEFAULT printing. Only 
LITERALS enclosed in quotation 
marks are printed in upper and 
lower case, if you type them that 
way. 


Change the main routine of the 


program (and line 115) as shown. 


PROGRAM 


115 (press |_RTN }) 
25 R=10 


30 S=1 


35 ON S GOSUB 45,75 


40 GOTO 35 


45 REM LEFT TO RIGHT 
90 FOR C=0 T0 39 


99 GOSUB 100 


60 NEXT C 


65 S=2 
70 RETURN 





EXPLANATION 


Delete statement 115. 


Re-enter statement 30 with a_ 
new line number to make room 
for other statements. 


Give S a value of 7 for use in 
selecting a subroutine in the 
computed GOSUB statement on 
line 35. 


Use a computed GOSUB state- 

ment to branch to subroutine 45 
when S=1 or to branch to sub- 
routine 75 when S=2. 


Send Aquarius back to the com- 
puted GOSUB statement when it 
returns from subroutine 45 or 75. 


This subroutine provides column 
positions for subroutines 100 and 
200. 


Program branches to nested 
subroutine 100, which moves the 
ball from left to right. 


Note that S is set to 2 at the 
end of the subroutine, so that 
Aquarius will branch to 
subroutine 75 when it executes 
the computed GOSUB statement 
on line 35. 
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75 REM RIGHT TO LEFT This subroutine moves the ball 
80 FOR C=39 T0 O STEP -1 from right to left. Note that S is 
85 GOSUB 100 set to 1 at the end of the sub- 
90 NEXT C routine, so that Aquarius will 

95 S=1 branch to subroutine 45 when it 
97 RETURN executes the computed GOSUB 


Statement on line 35. 





Subroutines 100 and 200 remain unchanged, except for the deletion of 
line 115 in subroutine 100. This line was deleted so that the ball would 
travel all the way to column 39 before returning. 


RUN the revised program, using [ CTL ]{ C ] to stop it. 


You can use Aquarius” to create 


ADDING SOUND — an astonishing range of sounds 


by specifying duration and tone 


THE FROSTING ON with the SOUND statement. You 
THE CAKE! don’t have to be an audio 


engineer either. You'll have more 
fun just experimenting with dif- 





Sound is made up of two things ferent numbers for tone and 
— DURATION and TONE. duration. In general, the HIGHER 
THE DURATION NUMBER, THE 
DURATION is the length of LONGER THE SOUND. THE 
time the sound lasts. HIGHER THE TONE NUMBER, 


THE LOWER THE TONE. 


TONE is the relative ‘pitch’ of 
the sound. 





Here is how you write the 
SOUND statement. Notice that 
there is no space between the 
key word SOUND and the first 
parenthesis. 





SOUND(50,5) 


SPECIFY COMMA _ SPECIFY 
DURATION TON 





Experiment with SOUND in tm- 
mediate Mode. If you don’t get 
any sound at all, you may have 
specified a pitch that is out of 
hearing range for the human eal 
(though you may cause a dog's 
ear to perk up). 


Example: 


SOUND (50,50) 
Creates a high-frequency tone. 


SOUND (50,500) 
Creates a low-frequency tone. 


SOUND (0,500) 
No sound created. 
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Let's add one last nested subroutine to our bouncing ball program, to 
add a sound effect each time the ball moves on the screen. 


PROGRAM 


205.GOSUB 300 


300 REM SOUND BEEP 


310 SOUND(50,5) 


320 RETURN 


EXPLANATION 


Add a statement in subroutine 
200 to branch to subroutine 300 
before the time delay loop is 
executed. 


Use a REMARK statement to 
identify subroutine 300. 


Generate a sound with a duration 
of 50 and a tone of 5. 


Tell Aquarius to return to the 
Statement following the GOSUB 
statement from which it left on 
line 205. This will execute the 
time delay loop after each sound 
is generated. 





COMPUTER TALK 
| Ft ff 
BEE 


CALL. Another word for branch. 
To ‘‘call’’ a subroutine means 
the same thing as to “‘branch 
to’’ a subroutine. 


COMPUTED GOTO/GOSUB. A 


statement which causes 
Aquarius to branch to one of 
several lines or subroutines, 
depending on the value of the 
numeric variable contained in 
the statement. 





DURATION. The length of time 
that a sound lasts. 


MAIN ROUTINE. That part of a 
program from which all sub- 
routines branch. A program 
minus subroutines. 


NESTED SUBROUTINE. A sub- 
routine that branches off from 
another subroutine. 


SUBROUTINE. A group of state- 
ments that branch off from the 
Main Routine of a program 
and end in a RETURN state- 
ment, which sends Aquarius 
back to the Main Routine. 


TONE. The relative “pitch” of a 
sound. 





ed §=CONTROL 
4@ SHORTCUTS 





@a=n8 


GOSUB...[_CTL }{7 ] 
RETURN...[ CTL }[8 ] 
REMARK...[ CTL }{ W ] 
ON... CTL ][6 ] 
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CHAPTER 8 


“READ...DATA— 
THE 
EFFICIENCY 
EXPERTS” 


(READ, DATA, 
RESTORE) 








Let's make up a simple color It's not hard to see that this pro- 
quiz program. This quiz will ask gram is very repetitious...and 

for the color of 5 different ob- longer than it has to be, if you in- 
jects and tell us if our answer is clude 5 questions. (A 5-question 

correct. You don’t have to enter quiz program like this would re- 


this program, just read through to quire more than 25 statements.) 
see how it works. 


1U 
20 
30 
40 
30 
60 
70 
80 


90 
100 
110 
120 
130 
140 


We can write our quiz program 
much more efficiently, using the 





“Color Quiz 1” READ and DATA statements. 
Here is the same quiz, with all 5 

PRINT CHR$(11) questions, in 14 statements. We 
PRINT *‘What color is theskyn ; could also write it as a 
INPUT 0$ 10-question quiz and we would 
IF 0$ = ‘“‘Blue’’ THEN 70 only have to add 2 more state- 
PRINT ‘‘Not exactly ments. Enter the program below. 
GOTO 80 Just copy it for now and see how 
PRINT Very good! ’ it works. Then we'll explain it. 
PRINT ‘‘What color is an 
elephantr 
INPUT 0$ 


IF 0$ = ‘‘Gray’’ THEN 130 
PRINT ‘Not exactly 

GOTO 140 

PRINT ‘‘Very good! 

PRINT ‘‘What color is 

etc. etc 








“Color Quiz 2” 


10 PRINT CHR$(11) 

20 READ A$,BS 

30 IF A$=‘‘OOPS” THEN 110 

40 PRINT ‘‘What color isn’’; Ad: 

50 INPUT 0$ 

60 IF 0$=B$ THEN 90 

70 PRINT ‘‘Not exactly °' 

80 GOTO 20 

90 PRINT ‘‘Very good!” 

100 GOTO 20 

110 PRINT ‘‘That’s all. You did very 
well.’ 

120 DATA ‘‘the sky’’, ‘‘blue’’, 
‘an elephant’, ‘‘gray’’ 

130 DATA “‘grass’’, ‘green’, 
““wheat’’, ‘‘gold’’ 

140 DATA ‘‘a strawberry”’, 
‘‘red’’, ‘“OOPS"', ‘‘OOPS”’ 





NOTE: When you enter lines 
110-140, type in the entire line 
before you press | RTN |. 





WHEN YOU HAVE A VARIABLE 
IN A PROGRAM AND YOU 
NEED TO USE IT SEVERAL 
TIMES, WITH A DIFFERENT 


VALUE ASSIGNED TO IT EACH 
TIME YOU USE IT, THE READ 
AND DATA STATEMENTS LET 
YOU: 

e Store all the values for that 
variable in a DATA statement: 
and 


e Call those values out of 
memory, one at a time, with a 
READ statement that assigns 
those values to one or more 
variables. 


READ 


A READ statement is like a 
super-efficient LET statement. It 
sets up one or more variables, 
then gets values for those vari- 
ables from a DATA statement 
and stores them for later use. 





Here are some examples of 
READ statements: 


10 READ A 
20 READ D$ 
30 READ A,B,FS 


NOTICE THE COMMAS SEPARATING 
VARIABLES. 





Statement 10 tells Aquarius,” 
‘Go to the current DATA state- 
ment. Read the next item of data 
you find there and store it as the 
NUMERIC VARIABLE A. 


Statement 20 tells Aquarius to 
find the next item of data and 
store it as the STRING 
VARIABLE D$§. 


Statement 30 says, ‘‘Go to the 
current DATA statement. Read 
the next item of data you find 
and store it as numeric variable 
A. Read the next item after that 
and store it as numeric variable 
B. Read the next item after that 
and store it as string variable 
F$.”’ 


IF A READ STATEMENT SENDS 
AQUARIUS LOOKING FOR 
NUMERIC DATA AND IT FINDS 
STRING DATA INSTEAD (OR 


VICE VERSA), IT WILL GET CON- 


FUSED AND GIVE YOU ATM 
(Type Mismatch) ERROR 
MESSAGE. 
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The DATA statements in a pro- 
gram establish ALL the values 
that the variables set up in the 
READ statement(s) will have. 
These values include NUMERIC 
and/or STRING CONSTANTS. (No 
variables allowed here.) 


You can store as many values in 
a DATA statement as you like, 
UP TO THE MAXIMUM LINE 
LENGTH. This works out to about 
64 characters. However, it is 
sometimes easier to work with 
data when you enter related sets 
of values in separate DATA state- 
ments. 





Example: 


READ P,R,N 


DATA 100,7,5 


DATA 300,7,8 





Where P is principal, R is rate 
and N is number of years. 


Rather than: 


READ P,R,N 


DATA 100,7,5,300,7,8 


Though this is perfectly legal. 





SOME IMPORTANT THINGS 
TO KNOW ABOUT DATA 
STATEMENTS ARE: 


1. If there is a READ statement, 
there must be at least one DATA 
Statement. 


2. ALL DATA statements in a 
program are considered a DATA 
BLOCK, even if they are located 
in different sections of the pro- 
gram. You can place DATA 
Statements anywhere you like. 
Many programmers prefer to 
place all DATA statements 


together at the beginning or end 
of a program. Others place them 
near the READ statements to 
which they relate. 


3. There must be at least as 
many items in the DATA BLOCK 
as there are variables in the 
READ statements. If Aquarius 
loops 5 times to a READ state- 
ment containing 6 variables, then 
there must be at least 30 values 
in the DATA BLOCK. 


4. The items in a DATA BLOCK 
are read in sequence from left to 
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right, in order of line number. 
You cannot skip around within 
the data block, selecting par- 
ticular items to read. Imagine a 
pointer that moves past each 
item in the data block, after that 
item is read. Aquarius” goes to 
the item CURRENTLY BEING 
POINTED TO each time it en- 
counters a new READ variable. 


Ok 
10 DATA 100,200,300,400,500,600,700 @ 





DATA ITEM CURRENTLY BEING READ. 


5. The value CURRENTLY BEING 
POINTED TO in the DATA 
BLOCK must match IN TYPE the 
variable CURRENTLY BEING 
ASSIGNED A VALUE in a READ 
Statement. A string variable can- 
not be given a numeric value. 


Example: 


READ G1,A$,BR$ 
DATA 10,‘‘Contented’’,‘‘Cows”’ 


READ G1,X,BR$ 
DATA 10,‘‘Contented’’,““Cows” 


2 el 


CORRECT: 
Values match variables. 


INCORRECT: 

String constant ‘‘contented”’ 
does not match numeric 
variable xX. 


[a eS a 


The example below shows how READ and DATA statements work 


together. 


10 READ A,B$,C9 
20 DATA 7,’ ‘Hi’’,10,55,°*Box’’ 2 


30 PRINT A 


40 IF C9=10 THEN PRINT BS 


Aquarius sees the READ state- 
ment and goes looking for a 
DATA statement. It finds the 
DATA in line 20 and reads the 
first 3 values. It stores numeric 
constant 7 as numeric variable 
A, string constant “‘Hi’’ as string 
variable B$, and numeric con- 
stant 10 as numeric variable C9. 


Aquarius proceeds to line 30. It 
prints the value stored in A, 
which is 7. 


In line 40 Aquarius checks to see 
if C9= 10. It does, so Aquarius 
prints the value stored in B$, 
which is “Hr”. 


enema, 
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00 IF C9<>10 THEN STOP 
60 GOTO 10 


In line 50 Aquarius checks to see 
if C9 is greater or less than 10. It 
igs not, so Aquarius goes on to 
line 60, which returns it to the 
READ statement in line 10. 


Aquarius goes back and READS 
more DATA, picking up WHERE 
IT LEFT OFF. It assigns a new 
value of 55 to A, a new value of 
‘Box’ to B$ and a new value of 
2 to CY. 


It prints A, which is 55. It checks 


_to see if C9= 10, finds the ex- 


pression false, so goes on. It 
checks to see if C9 is less or 
greater than 10, finds the expres- 
sion true and STOPS. 








OUT OF DATA 


When Aquarius has read ail the 
items in the data block, it stops. 
The pointer does not reset to the 
start of the data block again So 
if you have more READ variables 
than you have DATA items, you 
will eventually see this message: 


? OD Error in 20 
Ok 





¥ 


This means that Aquarius went to 
the cupboard and the cupboard 
was bare. OD stands for OUT OF 
DATA. 


There are two ways to avoid get- 
ting the dreaded OD message. 
One is with a FLAG. The other is 
with the RESTORE statement. 
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THE FLAG 


A flag is an UNLIKELY CON- 
STANT placed at the end of the 
data block. It is used with an 
IF..THEN statement to stop pro- 
gram execution or send Aquarius 
elsewhere in the program, when 
the data block runs dry. 


To see how this works, let’s 
return to our ‘Color Quiz 2” pro- 
gram. It shouldn't look quite so 
Strange now. Look at lines 30 
and 140. The last value in the 
data block is the last value in line 
140. That string constant is 
“OOPS”. Line 30 tells Aquarius 
to keep an eye out for “OOPS” 
and branch down to the ending 
Statement in line 110 when it en- 
counters it. It's that simple! 


There is one caution you must 
take in setting a flag. If you are 
working with both numeric and 
string variables in your READ 
Statements, make sure your 
FLAG matches IN TYPE your last 
variable read. 





RESTORE 


The RESTORE statement sets the 
pointer back at the beginning of 
the DATA BLOCK or to the 
beginning of a particular DATA 
STATEMENT. This lets you 
REPEAT data items as often as 
you wish, before continuing on in 
the data block. 


Example 1: 


lf you want to store the same 3 
values as 2 sets of variables, use 
RESTORE between the 2 READ 
Statements. 


10 READ A,B,C 

20 RESTORE 

30 READ X,Y.Z 

40 PRINT A:B;C 

90 PRINT X:Y¥;Z 

60 DATA 5,10,15,20,25,30 


This example will cause Aquarius 
to print: 





Example 2: 


lf you want to return to a par- 
ticular DATA statement, use 
RESTORE with a LINE NUMBER. 


10 READ A$,B$,C$ 

20 RESTORE 

30 READ X$,Y3,Z$ 

40 PRINT ASi ‘RA’ BS; RCS 
90 PRINT X$:"°R' SYS) 5ZS 
60 READ Q$,R$,S$ 

70 RESTORE 120 

80 READ 1$,U$,V$ 

90 PRINT Q$;"'H RS) RSS 
100 PRINT T$.' RUS; AVS 
110 DATA *'Oh happy , ‘ day! 
120 DATA °' feel’, ‘‘great!”’ 





( 








- This example will cause Aquarius “==@ 
eon P ‘ COMPUTER TALK ‘ CONTROL 

a SHORTCUTS 

30 READ Revsz5 DATA BLOCK. All of the data READ..[ CTL }[ D ] 
om 0 PRINT XS" YS values contained in all of the 
— 70 RESTORE 120 DATA statements in a DATA...[ CTL }{ F ] 
- ok OS program 
a pA encidem | FLAG. An unlikely value placed 

ee great! at the end of the DATA 
— " BLOCK. A flag is used with an 

IF... THEN statement to stop 

r program execution or cause 
_ Aquarius to branch to another 


part of the program when the 
— end of the data block is 
reached. 
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CHAPTER 9 


“MAXIMUM _ 
STORAGE WITH 
ee \-1-7.\ io 


(Array Variables, 
Multi-Dimension 
Arrays, DIM, CLEAR) 
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One way to store a number of 
values for a variable is with 
READ and DATA statements. 
These statements are particularly 
useful when you have a number 
of values to be used IN A PAR- 
TICULAR ORDER. 


But what if you will not be using 
data values in sequential order? 
Imagine that you want to keep 
track of your household ex- 
penses for one year. You want to 
set up different spending cate- 
gories, such as Food, Gasoline, 
Electricity, Phone..etc. You then 
want to store each month's ex- 
penditures for each category. 


— =_ . | 


And you want to be able to easily 
get the data on ANY particular 
month's expenditures in ANY 
particular category, perhaps for 
comparison purposes. 


Then you need to store this data 
in ARRAY VARIABLES (also 
called SUBSCRIPTED 
VARIABLES.) Why? Let's look at 
arrays and find out. 


If a variable is like a box in which 
you store a value, an array vari- 


able is like a large box divided in- 


to a number of compartments (as 
many as you like). You can store 
a different value in each com- 





partment and still keep all the 
values together under one 
general label (Such as Food, 
Gasoline, etc.) You can set up an 
array with either numeric or 
string values in it, but you cannot 
mix both types of values in the 
same array. 


Each value stored in one of the 
compartments in our large box is 
called an ARRAY ELEMENT. 
(Each month's expenditures in a 
spending category would be an 
element in that category's array.) 
Each array element is identified 
by a NUMBER in parentheses, 
next to the variable name. This 
number is called a SUBSCRIPT. 
(Hence the name Subscripted 
Variable). 


Example: 

X$(5) is an array element in a 
STRING ARRAY which has at 
least 6 elements. 


FOOD (11) is an array element in 
a NUMERIC ARRAY which has 
at least 12 elements. This might 
be the 12th month's expenditures 
in an array that stored all FOOD 
COSTS for one year. 


Mia] e-) 748) 


ARRAY 





When you set up an array vari- 
able, you first decide how many 
different elements you need to 
cover all the data items you will 
be using. If theré are 12 items in 
your data block and you want to 
be able to use any of them at 
any time, you will need an array 
with 12 elements. Array elements 
are numbered starting at 0, so 12 
elements would be numbered 0 
to 11. 


Once you decide how many ele- 
ments you want in your array, 
you pass this information along 
to Aquarius” via a DIMENSION 
(abbreviated DIM) statement, that 
also assigns the array variable 
name. 


Examples: 
DIM FOOD (11) sets up a 


numeric array variable FOOD 
with 12 values. 





DIM A&(9) sets up a string array 
variable A$ containing 10 values 
(0-9). 


DIM X(29), (24) sets up 2 
numeric arrays, X and Y. X con- 
tains 30 elements. Y contains 2a 
elements. 


In the programs that you write, 
be careful not to assign values to 
more elements than you have 
allowed for in your DIM state- 
ment. If you dimension an array 
X$(4) and try to assign a value to 
X$(5), you will get a BS Error 
message. (BS stands for Bad 
Subscript.) This means your sub- 
script (5) was OUT OF RANGE 
for the array dimension. 


Note: You do not need to dimen- 
sion an array that contains 10 
elements or less, but it is a good 
programming practice to do So. 
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DIMENSIONS — THE 
CLEAR STATEMENT 





Once you establish the dimen- 
sion of an array, the only ways to 
change it are with the NEW com- 
mand (which erases everything in 
memory) or the CLEAR state- 
ment. The CLEAR statement 
ERASES THE VALUES STORED 
IN ALL VARIABLES UP TO THAT 
STATEMENT. 


Example: 


10 DIM FOOD (11) 


20 FOOD(O) = 300.00 


30 FOOD(1) = 290.00 
40 FOOD(2) = 330.00 
50 ? FOOD(O) ,FOOD(1) ,FOOD(2) 


60 CLEAR 


70 PHONE(O) = 70.00 
80 PHONE(1) = 52.00 


90 ? PHONE(0) ,PHONE(1) 


100 ? FOOD(0) ,FOOD(1) ,FOOD(2) 





Establishes a string array with 
room for 12 elements. 


Assigns values to first 3 
elements of the array. 


Prints values of first three array 
elements. 


Sets dimensions of FOOD to 0. 
sets values of FOOD(0), FOOD(1) 
and FOOD(3) to zero. 


Assigns values to PHONE(O) and 
PHONE(1). 


Prints values of PHONE(O) and 
PHONE(1). Notice that these 
values were not affected by the 
preceding CLEAR statement. 


Prints value of FOOD array 
elements which are now blank 
(represented by Aquarius as QO). 





Be careful that you don’t accidentally erase the value of a variable 
which you want to use again. If you do, re-assign the erased value to 


that variable. 





CHAPTER 9 


9-3 


+ ee 0] bm fe r 


























ASSIGNING VALUES 


TO AN ARRAY 





Once you set up an array, you 
can assign values to the array 
elements in three ways — with 
LET statements, INPUT state- 
ments or READ and DATA 
statements. 


The LET statement is useful if 
you have a small array. 


Example 1: 


10 DIM FOOD(2) 

20 FOOD(O) = 300.00 
30 FOOD(1) = 280.00 
40 FOOD(2) = 330.00 





lf array values are to be assigned during program run, use the INPUT 
statement. The example below uses arrays in calculating the average 
weight of up to 100 people. 


PROGRAM 


40 


50 


60 


70 


80 


90 


INPUT “How many people did 
you weigh’ ';P 

DIM W(P) 

FOR |\=1T0P 


? “Weight number’; |;"‘nis *; 


INPUT W(1) 


T=T + Wil) 


NEXT | 


AV=T/P 


?*‘Average weight is’’:AV 


EXPLANATION 


Array has room for the same 
number of elements as people 
weighed. 


Loop creates variable | with 
values from 7 to P. 


Prompts the next INPUT state- 
ment. 


Sets subscript for array element 
as current value of |. Stores 
weight entered as value of this 
array element. 


Adds weight entered to current 
total. 


Signals next repetition of loops 
up to maximum value of P. 


Formula calculates average 
weight. 


Prints result. 
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When you have a large array, it Example 1: Example 2: ; 
is often easier to READ values o 
from a DATA statement. 10 DIM X(19) 10 DIM X(9),¥(9) oc 
(However, this does use a lot of Li i 
memory space.) 20 FOR B = 0 TO 19 20 FORB = 0 T09 Boce 
30 READ X(B) 30 READ X(B),Y(B) x 
yy 40 NEXT B 40 NEXT B 5 , 
BT) edi 50 DATA 5,10,15,20,25,30,35,40, 50 DATA 5,10,15,20,25,30,35,40, aeae| 
JING 45,50 45,50 
60 DATA 55,60,65, 70, 75,80,85, x0) = -¥(0) X(N), (1) 
90,95, 100 


60 DATA 55,60,65,70,75,80,85, 
The example above accomp- 90,95, 100 
lishes in 6 statements what it 
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would have taken 21 statements 
to accomplish, if we had used 
LET statements. 


In this example, X(0) would be 
assigned a value of 5. Y(Q) would 
be assigned a value of 10. X(1) 
would have a value of 15; Y(1) 
would have a value of 20...and 
SO on. 
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MULTI-DIMENSIONS 





The arrays that we have looked 
at so far are all ONE- 
DIMENSION arrays. This is the 
kind of array that you will prob- 
ably use most often. But it is not 
the only kind. You can have two- 
dimension, three-dimension, up 
to five-dimension arrays. 


If you think of a one-dimension 
array as a single ROW of values, 
then a two-dimension array is a 
MATRIX with ROWS and COL- 
UMNS. The subscript on a two- 
dimension array element there- 
fore contains TWO numbers (or 
COORDINATES). The first coor- 
dinate tells the row and the sec- 
ond coordinate tells the column. 
You can think of your TV screen, 
for example, as a two-dimension 
array of positions, labeled by row 
and column coordinates. 


X(3,4) is a element in a two- 
dimension array. The value of 
X(3,4) is located in Row 3, Col- 
umn 4 of the two dimensional 
array X. 


How about a three-dimension ar- 
ray? What might we use a three- 
dimension array to represent? 
How about a chart of financial 
obligations, based on balance 
owed, rate of interest and month- 
ly payment. The first dimension 
would be the balance owed; the 
second dimension would be the 
rate of interest; and the third 
dimension would be the monthly 
payment. 


lf a two-dimension array contains 
two coordinates, then a three- 
dimension array should contain 
three coordinates..and it does! A 
four-dimension array contains 
four coordinates and a five- 
dimension array contains five 
coordinates. In fact, you can 
always tell the number of dimen- 
sions of an array by the number 
of coordinates in its subscript. 





You can also tell the total num- 
ber of array elements in a multi- 
dimension array by adding 1 to 
each coordinate, then multiplying 
the coordinates together. For ex- 
ample, a two dimension array 
with the coordinates (9,9) would 
contain a total of 100 elements. 
The maximum number of ele- 
ments you can have in any array 
(no matter how many dimensions 
it has) is approximately 400. And 
it doesn't take long to use up 
400 elements in a five-dimension 
array. DIM X(2,2,2,2,2) for ex- 
ample, contains 243 elements. 
DIM X (3,3,3,3,3) contains 1024 
elements! If you attempt to 
establish an array that contains 
too many array elements, 
Aquarius’ displays the OM (Out 
of Memory) message. 


Use multi-dimension arrays spar- 
ingly. They eat up memory 
quickly! 
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In the following program, you de- 
fine an array called CL that con- 
tains the screen positions for the 
upper left-hand corner of the 
Color RAM Matrix. After loading 
the array with screen positions, 
you use the array elements in 
POKE statements that draw cot- 
ored lines on the screen. 


PROGRAM 
NEW 
5 2CHR$(11) 


10 DIM CL(3,3) 


20 FOR R=0 10 3 
30 FOR C=0 T0 3 


40 CL(R,C)=12328 + 1024 +(R*40)+C 


90 NEXT C 
60 NEXT R 


70 C=0 


80 FOR R=0 T0 3 


CONTINUED ON NEXT PAGE 





EXPLANATION 
Erase memory. 
Clear the screen. 


Reserve space for a 2-dimension 
array containing up to 16 ele- 
ments (that is, 4 times 4). 


Use a nested FOR-NEXT loop to 
load screen positions in the array 
based on row and column 
numbers. 


Calculate the position for 
each row/column coordinate 
(R,C) in a 4 by 4 square in the 
upper left-hand corner of the 
Color Ram Matrix. 


Indicate the end of the loop for 
variables C and R. 


Set variable C to 0 so that you 
can draw a red line in that 
column. 


Use a FOR-NEXT loop to incre- 
ment the value of R, representing 
row positions. 
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90 POKE CL(R,C),1 Use the array CL to represent SUBSCRIPTED VARIABLE. 
screen positions based on row/ Another name for an array. 
column coordinates. 

100 NEX ; ee 

ie ageate ie end of we FOR” | BF| contro 
© SHORTCUTS 





a 


110 PRINT:PRINT 
Move cursor down 2 rows DIM...{-CTL }{ E ] 








When you RUN your program, 





Aquarius” draws a vertical red COMPUTER TALK 

line from the home position. Try 

changing lines 70 to 100 to draw 

a horizontal red line in the third 

row. ARRAY. An ordered list of values 
assigned to a numeric or 

70 R=? string variable. 

80 FOR C=0 TO 3 | ARRAY ELEMENT. An individual 


value stored in an array. 
90 POKE CL(R,C), 1 DIMENSION. The number of ele- 


100 NEXT C ments in an array. 


. MATRIX. A set of values arranged 
110 PRINT: PRINT in rows and columns. 


SUBSCRIPT. The number in 
parentheses next to the array 
variable name, which identifies 
a particular element in the 
array. 


2 


7 a 4 
| | 1 | | | | ( 





A function works like a built-in mini-program that has one job to do. 
That job is to generate a single value or result that you can print or use 
as a value in an expression. (We say that a function RETURNS a single 
value.) A function is therefore never used alone as a program state- 
ment. It is always used with another keyword (or keywords) such as 
PRINT or IF..THEN. 
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“FUNCTIONS — 
THE SUPER 





— 55 10 IF Y > SQR(39) THEN 80 These statements all contain 
no) (O) SR OLOR RS functions. SQR, CHR$ and FRE 
= 10 PRINT CHR$(11) are all FUNCTION NAMES. 
— = ae 10 PRINT FRE(X) (39, (11) and (X) are 
= NUMDETS, S, ARGUMENTS. An argument is 
FRE, LEFT$, MID$, THE VALUE ON WHICH A 


FUNCTION OPERATES to return 
a single result. SQR(39) returns 
the square root of 39. CHR$(11) 
returns the control character that 
clears the screen. FRE(X) returns 
the number of unused bytes of 
memory. 


= RIGHT$) 
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AN ARGUMENT IS ALWAYS 
ENCLOSED IN PARENTHESES. 





There are many functions permanently stored in your AquariuS com- 
puter’s memory. All are available to you whenever you need them. 
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DIFFERENT KINDS 


OF FUNCTIONS 





Aquarius™ uses three types of 
functions: NUMERIC, STRING 
and SYSTEM. 


NUMERIC functions return a 
numeric value. SQR(X) is a 
numeric function that returns the 
Square root of any numeric value 
assigned to (X). Numeric func- 
tions are handy to have around, 
because they take care of messy 
mathematical operations (like 
finding square roots, sines and 
cosines, etc.) for you. 


STRING functions may: 


e Return one or more characters 
from a character string. 


Example: LEFT$(X$,1) 


e Convert a character string con- 
taining numbers into a numeric 
value. 


Example: VAL(X$) 


e Convert a numeric value into a 
character string. 


Example: STRS(N) 
SYSTEM functions: 


e Provide information about the 
amount of memory available to 
you. FRE(X) 


e Give control over HOW things 
are displayed on the screen. 


Example: CHR$(11) 


e Provide information about the 
contents of memory locations. 


Example: PEEK (12328) 


We will take a closer look in this 
chapter at a FEW commonly 
used functions. See the 
Reference Section, pages 40 to 
55, for descriptions of all 
Aquarius functions. 





NESTED FUNCTIONS 





The argument of a function may 
be another function. This is 
called NESTING and the function 
that provides the argument is 
said to be nested within the other 
function. For example, we could 
take the square root of a number 
contained in a character string. 
Then the function that returns a 
numeric value for a number con- 
tained in a character string, 
VAL(X$), would become the argu- 
ment for the SQR function. The 
entire function would look like 
this: 


10 X$=''1063 HIGHLAND STREET”’ 
20 PRINT SQR(VAL(X$)) 


Aquarius would print the square 
root of 1063. 


One of the most frequently used 
examples of nested functions is 
random number generation. We 
will look at random numbers 
next. 
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RANDOM 


| NUMBERS — GAMES 
OF CHANCE 





lf you want Aquarius” to pick a 
number at random from a certain 
range of numbers, use the RND 
(Random) function. If you want 
Aquarius to pick a WHOLE 
number at random from a range 
of whole numbers, use the RND 
function, nested within the INT 
(Integer) function. (An integer is a 
whole number.) 


Random number generation is 
just about essential in creating 
any game where chance is an 
element. Random numbers are 
most useful when they are whole 
numbers. In a game where dice 
are rolled to determine moves, a 
roll of 3.146 would be 
meaningless. 


When you generate a random in- 
teger, you actually generate a 
RANGE of random integers — 
for example, a range of 11 


numbers from 5 to 15, including 
both 5 and 15. To do this you 
specify: 


e The LOWEST NUMBER in the 
range. Call this number A. In our 
example, A = 5. 


e The number of POSSIBLE inte- 
gers within the range. Call this 
number B. In our example, B = 
11. 





Our formula for generating a ran- 


dom integer (called X) is: 
X = INT(B * RND(1) + A) 
Note that (B* RND(1) +A) is the 


nested function within the INT 
function. 
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The statement used to print a 
random integer generated by our 
formula could be either: 


PRINT INT(B * RND(1) + A) 
Or: 
X=INT(B * RND(1) + A): PRINT X 


Plug the values from our exam- 
ple into one of these statements 
and we get: 


PRINT INT(11 * RND(1) + 5) 





BY THE WAY 
= } The argument for the 
amas PND function can be 
any whole, positive number. The 
number chosen does not affect 
the results of the function. This 
kind of argument is called a 
DUMMY ARGUMENT. (However, 
if you use 0 as the argument for 
RND, the last number generated 
will be repeated.) 





The following ‘‘Multiplication 
Tables’”’ program generates a 
random integer for use ina 
‘times tables’’ drill. 


“Multiplication 





Tables” 


PROGRAM 
NEW 
9 ? CHR$(11) 


10 J = INT(11*RND(1) + 2) 


20 FOR l=1 10 12 
30 GOSUB 100 

40 NEXT | 

90 GOTO 10 


100 REM PROMPT ANSWER 





EXPLANATION 
Clear memory. 
Clear the screen. 


Generate a random number be- 
tween 2 and 12, including 2 and 
12, to be used as multiplicand. 
Store this number as the variable 
J: 


Use FOR...NEXT loop to set 
values for multiplier and store 
values as |. 


Branch to subroutine 100. 


Signal next repetition of loop until 
end value of | is reached. 


Generate a new random number 
to be used as next multiplicand. 


Use REMARK statement to tden- 
tify subroutine. 
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110 K=I*J 


120 ?°‘What is’’:I:‘‘Atimes’’:J:‘'?”’ 


130 SOUND(25, 100) 


140 INPUT AN 


150 IF K<>AN THEN GOSUB 200 


160 IF K<>AN THEN GOTO 120 


170 IF K=AN THEN GOSUB 300 


180 RETURN 


CONTINUED ON NEXT PAGE 





Establish correct answer for 
each | times J and store answer 
as variable K. 


Print the question ‘‘What is | 
times J?” with current values of | 
and J inserted. 


Generate a sound to accompany 
the question. 


Stop program until answer is 
entered. Store answer as vari- 
able AN. 


Test the answer to see if it 
matches the correct answer K. If 
it does not, branch to subroutine 
200. 


Aquarius returns from subroutine 
200 to this statement, which 
sends it back to 120 to repeat 
the question. 


If AN equals the right answer K, 
branch to subroutine 300. 


End subroutine 100 and return to 
line 40. 
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200 REM WRONG ANSWER Use REMARK statement to iden- 


tify subroutine 200. 


210 ?'‘Oops. Try again!’'’:CHR$(10) Print wrong answer response and 
Skip one line after response. 

220 SOUND(50,50) Generate a sound to accompany 
response. 

230 RETURN End subroutine 200 and return to 
line 160. 


300 REM RIGHT ANSWER Use REMARK statement to iden- 


tify subroutine 300. 


310 ?''Right!’’:-CHR$(10) Print right answer response and 


Skip one line after response. 


320 SOUND(50,80) Generate 2 sounds to accom- 
pany response. 


330 SOUND(80,50) 


340 RETURN End subroutine 300 and return to 
line 160. 





RUN your ‘Multiplication Tables’? program now. When you are through, 


press | CTL |] C | to stop. 





CHRS$ — THE 


MULTI-FUNCTION 
FUNCTION 





CHR$ is the CHARACTER FUNC- 


TION. It is a very versatile string 
function that allows you to print 
characters from the entire char- 


acter set or to control the way in- 


formation is displayed on the 
screen. 


THE CHARACTER SET 


All of the letters, numbers and 
special characters on your key- 
board are members of the char- 
acter set. But this is not the 
ENTIRE set. There are 256 char- 
acters in the character set and 
each one of them is represented 
by a different number from 0 to 
255. This number is called a 
CHARACTER CODE. (You met 
character codes in chapter 6.) 
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Most of the characters can be printed on the screen, using a PRINT 
Statement. For example: PRINT CHR$(197), where 197 is the char- 
acter code. It is also the argument of the CHR$ function. Some are 
special graphics characters that can ONLY be printed by means of the 
CHR$ function, because they do not appear on the keyboard. You will 
find all characters and their character codes starting on page 6 of the 
Appendix. 





mE’ 4 % - © = = Tf lL fF#eAéay & 
mre The Aa Fat 
=, =" 35 = | " # € 4 & 7 € 
> *¥ + . @= , * & 1 2 8 4 5 
6 fr 8 FG: 3; €£ = > FT &@ A B 
C DE F GH IJ K LA A O 
P@ RS TU YV Ww YY 2 CS J 
~ . * q bcede#tgqAil jg 
k, mn, OP aa" of el ._* 
yz J al 
Het 4 ¥ 5% # as = 
— PF = a a = ". -_ ii. 
Aan. os oe. 2. 8 se PF 2s 
ark Ah He¢-: + 
: ll a 
| = “ Ob ark ra "7 
"" E “a 
_ = mh ‘e 


SPECIAL GRAPHICS CHARACTERS 








TRY THIS 
Use the CHR$ func- 
tion to print quotation 


marks as part of a string literal. 
The character code for quotation 
marks is 34. 


Example: PRINT CHR$(34) ‘‘My 
name is Aquarius.’’CHR$(34) 





You can display part of the 
character set with the following 
short program. 


10 FOR |=0 TO 255 

20 PRINT CHRS(I); 

30 FOR T=1 TO 50:NEXT T 
40 NEXT | 


When you RUN this program, 
Aquarius * will print the first few 
characters, then clear the screen 
and print the remaining char- 
acters in the character set. This 
happens when Aquarius reaches 
character code 11. By now 
you've used CHR§(11) often 

















enough to know what happens 
when Aquarius prints this 
member of the character set. 


If you want to display the EN- 
TIRE character set, including 
characters you cannot display 
using the CHR$ function, enter 
and RUN this short program: 


5 ? CHRS$(11) 

10 A = 12328 

20 FOR |=0 TO 255 
30 POKE A + | * 3, | 
40 NEXT | 

50 GOTO 20 


USING CONTROL 
CHARACTERS 


When used in the CHR$ function, 
some character codes do not 
cause a character to be dis- 
played. Instead, they control the 
WAY IN WHICH data is dis- 
played on the screen, in either 
Immediate or Programmed 


Mode. You have already seen 
how this works with CHR&(11). 
You can type ?CHR$(11) and 
press in Immediate Mode 
to clear the screen. Or you can 
type a line in a program — 

10 ?CHR(11) — to clear the 


screen when Aquarius executes 
tnat line. 


There are four other control char- 
acters, in addition to CHR$(11), 
that we will take a special look at 
here. 


CHRX7) — BELL 


To create a bell sound in im- 
mediate Mode, you can press 

| CTL |+ G |. But you cannot 
write LCTL }[G ] into a PRINT 
statement in Programmed Mode. 
If you want a bell sound to be 
generated during program execu- 
tion, use CHR§7) in a PRINT 
statement. 


Example: (0 PRIN! CHRS(7) 


When this statement’is executed, 
you will hear a bell sound. (You 
may have to turn the volume on 
your TV set up slightly.) 





CHARACTER DELETE 


To delete the character to the 
left of the cursor, when you are 
in Immediate Mode, you can 
press the [~!]. But this key only 
works in Immediate Mode. If you 
want a character to be deleted 
during program execution, use 
CHR&8) in a PRINT statement. 


Example: 
10 PRINT ‘'1234'’:CHR$(8) 


The semi-colon in this statement 
causes control character 8 to be 
‘printed’ next to the character 
String ‘1234’’. After ‘'1234" has 
been printed, the cursor is to the 
right of the number 4. Control 
character 8 then deletes the 
character to the left of the cur- 
sor. That character is the 
number 4. This happens so fast 
that all you ever see printed is 
the character string “123”. 


CARRIAGE RETURN 


To skip a line and return the cur- 
sor to the. start of the next line 


you can press in Im- 


mediate Mode. If you want to 
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skip a line and return the cursor 
DURING PROGRAM EXECU- 
TION, use CHR§$(10) or CHR$(13) 
ina PRINT statement. 


The differences between 
CHR$(13) and CHR$(10) are: 


e CHR$(13) MUST be used in its 
own PRINT statement. It 
causes only ONE carriage 
return to occur each time it is 
used. 


Example: 


PRINT CHR$(13) — 
One carriage return occurs. 


PRINT CHR$(13);CHR$(13) — 
Still only one carriage return 
occurs. 


CHR$(10) may be used in the 
Same PRINT statement with 
constants and variables. It can 
be used more than once in the 
same statement, to cause 
multiple carriage returns. If it is 
used BEFORE a constant or 
variable in the same PRINT 
statement, the carriage return 


occurs before the constant or 
variable is printed. 


Example: 


PRINT ‘‘Hello’’;CHR$(10) — 
Hello is printed, then carriage 
return OCCurs. 


OF: 


PRINT CHR$(10);CHR$(10) — 
Three carriage returns occur. 
(Three? That’s right. An extra 
carriage return occurs when 
two or more CHR$(10) control 
functions are used in succes- 
sion in a PRINT statement.) 


Or: 
PRINT CHR$(10):‘‘Hello’” — 


Carriage return, then Hello is 
printed at start of next line. 





OTHER HANDY 


FUNCTIONS 





FRE(X) — THE MEMORY 
MINDER 


Aquarius” provides you with 
1781 BYTES of memory to work 
with (1731 bytes for program 
Statements and numeric values, 
plus 50 bytes for string data). 
Each letter, number, special 
graphic character, space and 
punctuation mark you type 
equals 1 byte of memory. If you 
write a very long program, it is 
possible to run out of memory 
(and get the OM Error 
Message)..especially if you make 
much use of array variables. 


You can find out how many 
bytes of memory you still have 
available by using the FRE(X) 
function in a PRINT statement. 
You can use FRE(X) in either Im- 
mediate or Programmed Mode. 
The argument (the value in 
parentheses) for this function is 
called a DUMMY ARGUMENT, 
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which means it can be any 
number or letter as long as you 
do not enclose the argument in 
quotation marks. For example: 


PRINT FRE(X) 
When you press [ RTN ], 


Aquarius prints the number of un- 
used bytes of memory available 
to you. 


NOT: 


PRINT FRE(‘‘Bytes’’) or 
PRINT FRE(‘‘B’’) 


This will return the number of 
unused bytes available for string 
data in Immediate Mode. 


LEFT$, MID$ AND RIGHTS — 
MANIPULATING STRINGS 


We have seen that it is possible 
to store an entire string of char- 
acters under one string variable 
name. For example: NA$ = 
‘My name is Aquarius.”’ 


If you tell Aquarius to PRINT 
NAS, it will print, ““My name is 
Aquarius.’ Fine! But Aquarius 





can do more with a string of characters than print the entire string. You 
can tell Aquarius to print any part of a character string, starting from 
the left, the right or the middle of the string. To do this, use the LEFTS, 
MID$ and RIGHTS functions in a PRINT statement. 


10 A$ = ‘AQUARIUS’ You give A$ the value 
“AQUARIUS” 

20 PRINT A$ Aquarius prints ““AQUARIUS”’. 

30 PRINT LEFTS$(A$,4) Aquarius prints ““AQUA”’. 

40 PRINT MID$(A$,3,4) Aquarius prints ““UARI”’. 

50 PRINT RIGHTS(A$,4) Aquarius prints “RIUS”’. 





The arguments of LEFT$, and RIGHTS contain two elements. The first 
element is the NAME OF THE STRING VARIABLE being printed. The 
second element is the NUMBER OF CHARACTERS to be printed. With 
LEFT$ Aquarius starts at the left end of the string and prints the 
number of characters specified. With RIGHTS, Aquarius starts at the 
right end of the string and prints the number of characters specified. 


The argument of MID$ has three elements. The first element is the 
name of the string variable. The second element is the string character 
at which Aquarius is to begin printing. The third element tells the 
number of characters to print. 
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ARGUMENT. The value on which 
a function operates to return 
another value. CHR$(11) — 11 
is the argument of the CHR$ 
function. 


DUMMY ARGUMENT. An argu- 
ment that can be any number 
or letter. FRE(X) uses a 
dummy argument. So does the 
RND function. 


FUNCTION. A built-in ‘‘mini- 
program’’ that returns a single 
value that you can use ina 
program command or state- 
ment. 


INTEGER. A whole number. 
RANDOM NUMBER. A number 


selected at random from a 
range of numbers. 
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CHAPTER 11 


“DIGITAL 
CLOCK” 








In Chapter 5 we explored a program that set up a simple digital clock. 
In this, our final chapter, we will examine a more sophisticated version 
of the same program. As you enter each line of the program, read the 
accompanying explanation, so you understand why the program does 
what it does. When you are finished, RUN your digital clock and take a 
few minutes to admire your own handiwork. You see, you are no longer 
a beginner .. and it wasn't so hard, was it? If you have a cassette 
recorder hooked up to your Aquarius” computer, make sure you save 
this program. Now, let's get started. 





PROGRAM EXPLANATION 

10 REM--INPUT DATA Use REMARK statements to note 
what each section of your pro- 
gram does. 

20 ? CHRS(11)} Clear the screen. 

30 ? “‘Enter HOUR (1-12):”’ Input data for beginning hour 
(BH). 

35 INPUT BH 

40 |F BH > 12 THEN ? CHR$(7): Note: CHR$(7) creates a bell 

GOTO 30 sound. 

50 ? ‘Enter MINUTES (0-59): Input data for beginning minutes 

(BM). 


CONTINUED ON NEXT PAGE 
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=) 
CN EEE i amma 
= 
55 INPUT BM 
=) 
60 IF BM > 59 THEN ? CHR$(7): es 
GOTO 50 
| | | =) 
70 FH=BH:FM=BM FH is the first hour in the loop. 
FM is the first minute. When the a 
clock starts, the first hour and es 
the beginning hour are the 
same...as are the first minutes ea 
and the beginning minutes. w@ 
75 ? CHRS(11) Erase the cursor, by poking a es 
77 POKE 12369, 32 blank into that screen position. 
80 GOTO 400 Branch to subroutine that pokes aw 
screen color and clock face. w 
100 REM--PRINT DISPLAY This section prints the hour and ww 
minute display, using data input a 
in previous section. ‘) 
110 T = 11*40+17 Sets TAB position for start of o 
TIME display on line 17. ‘) 
125 CH=12328 + T Calculate starting position for ay 
TIME display on Character RAM 
Matrix. 
| | (a 
130 POKE CH,84: POKE CH+2,73: POKE letters T,1,M,E into posi- 
POKE CH+4,77: POKE CH tions on Character RAM Matrix. wu 
+6,69 NOTE: Do not press until e 
entire line 130 has been typed. 
CONTINUED ON NEXT PAGE Y 
) 





140 ND=CH+80 


150 POKE ND+2,58:POKE ND+5,58 


151 GOTO 200 


152 REM--TIME DELAY LOOP 


155 FOR P=0 TO 430:NEXT P 
160 RETURN 
200 REM--INCREMENT 


210 FOR H=FH 10 12 
211 FH=1 


212 H$=STR9(H) 


CONTINUED ON NEXT PAGE 


Calculate starting position for 
hour & minute display, 2 lines 
below TIME display. 


POKE colons (:) for hour and 
minute display. 


Branch to program section that 
increments seconds, minutes 
and hours. 


Line 155 sets up a one-second 
time delay loop (approximately). 


Return to line 245. 


This section increments seconds, 
minutes and hours. 


First loop sets value for hour. 


Reset the first hour to 1 after it 
passes 12. 


Use the STR$ function to change 
the NUMERICAL variable H into 
a STRING variable H$ that can 
be manipulated by string func- 
tions MID$ & RIGHTS. 
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214 1$(0)=MID$(H$,2, 1) Aquarius prints all numbers with 
a leading blank. Use the MID$ 
function to tell Aquarius to ignore 
the leading blank and regard the 
second digit of the string as the 
first digit of the hour. This digit is 
stored as T$(0) — the first ele- 
ment in string array T$. 


216 IF H< 10 THEN T$(0)=‘‘0"’ If the hour is a 1-digit number, 
you want a leading zero printed. 
(Ex: 07). Line 216 restores the 
leading zero for 1-digit numbers. 


218 1$(1)=RIGHTS(H$, 1) Use the RIGHTS function to get 
the right digit of the hour and 
store it as T$(1). This is the sec- 
ond element of array T$. 


220 FOR M=FM TO 59 The second loop, line 220 to 228, 
repeats the above process for 
minutes. 

221 FM = 0 Resets the minutes to 0 after 
they pass 59. 

222 M$ = STRS(M) Put first digit of minutes into a 
string. . 

224 T$(2) = MIDS(M$,2,1) Tell Aquarius to ignore leading 


blank and regard second digit of 


AN TIMUEDSON: NERPPACE string as first digit of minutes. 


pp ES en ea 


| | H | E | 
| 7 | 








226 IF M< 10 THEN T$(2)="‘0" 
228 1$(3) = RIGHTS(M$, 1) 


230 FOR S=0 T0 59 


231 IF S/5 = INT(S/5) THEN 
SOUND (50,50) 


232 S$=STRS(S) 
233 1$(4) = MID$(S$,2, 1) 


234 IF S< 10 THEN T$(4)="'0"" 
235 T$(5)=RIGHT$(S$, 1) 


236 FOR Q=0 TO 5: T(Q)=VAL 
(T$(Q)) + 48: NEXT Q 


CONTINUED ON NEXT PAGE 





Create leading zero for 1-digit 


. numbers. 


Put second digit of minutes into 
a String. 


Third loop increments seconds. 


Create a tone to be heard every 
5 seconds (whenever S is an 
even multiple of 5). 


Put first digit of seconds into a 
string. 


Create leading zero for 1-digit 
numbers. 


Put second digit of seconds into 
a String. 


This loop changes string values 
of T$ array elements back into 
numerical values, then adds 48 
to convert those numerical 
values to character codes that 
can be POKED into screen posi- 
tions. Character codes are stored 
as elements in numerical array T. 
NOTE: Do not press until 
entire line 236 has been typed. 
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237 POKE ND,T(0): POKE ND+1,T(1): POKE character codes for hours, 


POKE ND+3,1T(2):POKE ND +4, minutes and seconds into screen 
T(3) positions, skipping colons. Do not 
238 POKE ND+6,1(4):POKE ND +7, press until entire num- 
T(5) bered line has been typed. 
240 GOSUB 152 Branch to time delay loop. 
245 NEXT S Signal next repetition of seconds 
loop. 
250 NEXT M Signal next repetition of minutes 
loop. 
260 NEXT H Signal next repetition of hours 
loop. 
300 REM--REPEAT 12 HOUR LOOP 12 hours have now been 


counted. Start over again. 


310 GOTO 200 


400 REM--COLORIZE This section adds color and a 
“clock face’ to the screen. 
410 CA=12328+ 1024 Calculate starting position on 
Color RAM Matrix. 
420 FOR |=CA TO CA+959:POKE Loop calculates all positions on 
183: NEXT | the screen, then pokes violet 


foreground and yellow back- 


CONTINUED ON NEXT PAGE ground colors into all positions. 





| | 
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430 DIM X(11), (11) 


440 DATA 20,0,25,2,29,6,31,11,29, 
17,25,21 


450 DATA 20,22,14,21,10,17,9,11, 
10,6,14,2 


460 FOR ZZ=0 T0 11 


470 READ X(ZZ), Y(ZZ) 


480 POKE 13352 + X(ZZ) + Y(ZZ)* 
40,1 


490 NEXT ZZ 


495 GOTO 100 


Set the dimensions of two 
numerical arrays, X and Y. 
Values of the elements in these 
arrays are X and Y (column & 
row) coordinates for ‘‘clock 
face’’ squares. 


Loop sets 12 subscript values for 
X and Y array elements. 


Aquarius reads a value for X and 
a value for Y out of the DATA 
Statements, each time it loops 
through this statement. A total of 
12 values each is stored for X 
and Y. Each value is stored as a 
separate element of array X or 
array Y. 


POKES a red square into each 
position calculated by the X and 
Y coordinates. 

Signals next repetition of loop. 


Go back to line 100 and continue 
program. 





When you have entered this pro- 
gram, LIST it and double-check 
for any ‘‘typing”’ errors. If you 
find any, correct them by re- 
typing the line in which they ap- 
pear. When you have Carefully 
checked your program, RUN it. If 
your clock seems to be a little 
slow or fast, go back and adjust 
the number 430 in line 155. This 
is your ‘‘seconds’”’ counter. 


Congratulations! You have just 
entered your first major program. 
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INTRODUCTION 
TO 
REFERENCE 
SECTION 


WHAT HAVE | 
BOUGHT? 





You've bought a computer — a 
machine that manipulates 
numbers at super high speeds. 
That is ALL a computer does, but 
because it does this job so fast, 
it can be used to get many other 
jobs done. It can: 


e Receive DATA (facts that you 
provide). 


e Store data. 


e Give out data that has been 
stored. 


e Receive and store instructions. 


e Carry out instructions (provided 
it is connected to another 
machine capable of doing the job 
we request. For example, a com- 
puter can print a program only if 
it is hooked up to a printer. 


But a computer cannot do much 
by itself. It needs ‘‘helpers”’ to 
take in or give out data. Helpers 
that take in data are called IN- 
PUT DEVICES. Helpers that take 
data out from the computer are 
called OUTPUT DEVICES. The 


keyboard on your computer is an 
input device. The TV screen or a 
printer are output devices. 


THE MEMORY 


Net ali = 





A computer is useful because it 
is fast. It is also useful because it 
REMEMBERS. This is another 
way of saying that it ‘‘stores 
data’’. A computer stores data in 
the form of minute electrical 
charges. The amount of space 
required to store those charges 
is not great, but sooner or later, 
any computer will run out of stor- 
age space. The point at which 
this happens depends on how 
much memory space it has in 
the first place. Your Aquarius” 
computer has 4K (or 4096) 
BYTES of RAM. A byte equals 
the amount of memory space 
needed to store one character or 
space that you type. 


some of the memory in your 
Aquarius“ computer is needed 
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to run the computer and to inter- 
pret your BASIC language in- 
structions into the machine 
language that Aquarius 
understands. The amount that is 
left after these jobs are done is 
1781 bytes of RAM. 


WHY BASIC? 





Earlier we defined a computer as 
a machine that works with 
numbers. Actually, numbers are 
the only things that a computer 
really understands ... and only 
two numbers at that,O and 1.A 
limited vocabulary, you might 
say, but it’s quite sufficient for a 
computer. 


Remember that data is stored in 
a computer's memory in the 
form of tiny electrical charges. 
An electrical charge is either 
there or it’s not there. It’s on or 
it’s off. The command for ON is 
the number 1. The command for 
OFF is 0. So when data is 
stored, it is stored in strings of 
ones and zeroes, like this: 


SSS So ee 


01010001 110000 1010101 00010101 
11011011100100 1000111 11101011 
11110100010110 1101111 00010101 
01011101110000 1011100 00011110 
01111100010101 1001100 11110010 
01100011101010 1011101 11010110 
01111100001101 0101010 11111010 





This is MACHINE LANGUAGE, 
the language which our machine, 
the computer, speaks. If the 
computer is to understand the in- 
Structions we give it, those in- 
structions must be given in 
machine language. Unfortunately, 
machine language is extremely 
tedious for human beings to use. 
SO Our computer has a built-in 
INTERPRETER, that ‘‘translates’’ 
Our programs into machine 
language. 


But still, why BASIC? If Aquarius * 
contains a built-in interpreter, 
why can't we write our com- 
mands in English? The answer 
lies again in the very nature of 
computers. Computers do EX- 
ACTLY what we tell them to do 
... and English is not an exact 





language. Many English words 
have more than one meaning. 
For example, what does the word 
PLAIN mean? Or BEAR? We use 
special languages to speak to 
computers, so that we can give 
exact commands. There are 
many computer languages and 
BASIC is just one of them. The 
name BASIC stands for 
Beginner's All-purpose Symbolic 
Instruction Code. But more im- 
portant, BASIC stands for easy 
programming. 


In the following Reference Sec- 
tion, you can become familiar 
with the entire BASIC vocabulary 
built into your Aquarius com- 
puter. Some of the keywords in 
this section have been explained 
in earlier chapters of the book. 
Others you may meet here for 
the first tinte. The purpose of this 
section is to give you a brief 
description of the use and func- 
tion of each BASIC keyword. It is 
a ‘‘refresher course’, a handy 
guide that you can refer to when- 
ever you encounter a term you 
are unsure of. 
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KEYWORDS PAGE FUNCTIONS PAGE 





| | CLEAR R10 ABS R41 LL 
AQUARIUS CLOAD Ri1 | ASC Rao | $eb ae 
CONT R12 | CHR$ R42 | Pom 
COPY R13. | COS R43 i 
CSAVE Ri4 | EXP 7 R43 | Into 
REFERENCE DATA R15 FRE R44 | irre 
| DIM R17 | INKEY$ R44 | Iie 
nS) oi OBO)’ END R21 INT R45 | fra 
FOR/NEXT Roo? | LEFT$ R46 || 
sBaliseecreitielake(stxeiiescs | GOSUS R23 7 LEN R46 | 
GOTO R24 | LOG RAT | 
all the BASIC IF/THEN R25 | MIDS R47 | 
keywords and, | Aa | Foi | 
‘ ol 
functions you need for Hi Miiry | po7 | POS REC | 
Vdidiatem-lalom-p<creteaiarem@ | LIST R28 | RIGHTS R50 
on Aquarivc LPRINT Rog | RND R51 
programs q 7 | NEW R23 | SGN R52 
ON R29 | SIN R52 
POKE R31 SPC R53 
PRESET R32 | SOR R53 
PRINT R33 | STR$ R54 
PSET R32 | TAB | R54 
READ R34 | TAN... | R55 
REM R35 | USR R56 
RESTORE R36. | VAL R56 
RETURN aCe ei ae Re, Ree eee 
RUN | R39 + | RETYPE | R7 
SOUND R39 | STPLST R27 
STOP...... R40 
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“WHAT TO USE” 
INDEX 





If you know what you want 
Aquarius to do, but you can't 
recall the BASIC keyword or 
function you need, check this 
Index: 


LISTING, SAVING, 
LOADING AND 


RUNNING 
PROGRAMS 








TO DO THIS... 

e List program on screen 

e List program on printer 

e Copy screen display on printer 

e Record program on cassette 

e Record array on cassette 

¢ Copy program from cassette to memory 
e Copy array from cassette to memory 

e Verify copy program match 

e Run (execute) program 

e Stop program execution (can continue) 
e Continue a STOP-interrupted program 
e End a program run (optional) 

e Reset variables to zero or blank 

e Erase program and data from memory 


e Stop LIST display 


USE 
LIST 
LLIST 
COPY 
CSAVE 
CSAVE * 
CLOAD 
CLOAD * 
CLOAD? 
RUN 
STOP 
CONT 
END 
CLEAR 
NEW 


CTL & 
STPLST 





SEE PAGE 
R27 
R28 
R13 
R14 
R14 
R11 
R11 
R11 
R39 
R40 
R12 
R21 
R10 
R28 


R27 
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Ei TO DO THIS... USE SEE PAGE 
* CONTROLLING ra, Lu 
: e Branch to specified line GOTO R24 
_ PROGRAM os z 
a, EXECUTION e Compute branch to specified line ON...GOTO R29 Lu Oo 
ok 
= SEQUENCE e Conditional branch to specified line, or IF...THEN R25 Lu O 
i other operation (e.g., PRINT) TF vy) 
a. e Branch to specified subroutine line GOSUB R23 as 
- ¢ Compute branch to specified subroutine ON...GOSUB = R29 
e" ¢ After subroutine execution, branch to the = RETURN R38 
_ Statement following GOSUB 
-_ e Repeat enclosed statements specified FOR-NEXT R22 
—_ number of times 
_ e Specify FOR-NEXT increment, if other STEP R22 
than +1 
e Branch to user-created machine language USR R55 
Subroutine 


— 
_— 
_—, 
— 
— 
— 
—_, 
—_, 
—_—, 
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USING DATA AND 


VARIABLES 





TO DO THIS... 


e Print data inside quotation marks; print 
following variable(s); skip a line 


e Enter data during a program run; print 
data inside quotation marks 


e Assign a keystroke character to a string 
variable 


e Set variable values (optional) 

e Include data items in program 

e Read DATA statement items into memory 
e Set maximum size of an array 

e Return to first item in DATA block 


e Print program comments in LIST or LLIST 
display (can be branch destination) 


USE 


PRINT 


INPUT 


INKEYS 


Baa 
DATA 
READ 
DIM 
RESTORE 


REM 





SEE PAGE 


R33 


R26 


R44 


R27 
R15 
R34 
R17 
R36 


R35 
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| eee TO DO THIS... USE SEE PAGE 
EDITING OUTPUT e Display following data; skip a line PRINT R33 ¢) > 
¢ Send output to line printer LPRINT R28 iQ 
e Set cursor position (horizontal) TAB R54 Wi © 
e Display cursor position (horizontal) POS R50 a eee 
e Insert specified number of blanks SPC R53 
e Repeat line (before RTN) CTL & 
RETYPE 
| : TO DO THIS... USE SEE PAGE 
Rowse He + ae e Indicate if specified graphic square is set POINT R49 
aa. : e Put values in a specified memory location POKE R31 





to display special characters and colors 


e ‘Turn off’’ specified graphics block PRESET R32 
e “Turn on’ specified graphics block PSET R32 
e Sound tone, specify pitch & duration SOUND R39 ee | 


»eSeeseeseseeseeeeeeeseeeesses 
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USING CHARACTER 


STRINGS 





TO DO THIS... 


e Get character code for the first character 
in a string 


e Get character with specified code 
e Get number of characters in a string 
e Read a keystroke 


e Select specified number of characters 
starting from left end of a string 


e Select specified number of characters 
in middle of a string 


e Select specified number of characters 
starting from right end of a string 


e Convert a numeric expression into a string 
e Get numeric values in a string 
¢ Clear all variables. Reset numeric 


variables to zero. Erase contents of string 
variables 


USE 
ASC 


CHR$ 
LEN 
INKEY$ 


LEFT$ 


MIDS 


RIGHT$ 


STR$ 
VAL 
CLEAR 





SEE PAGE 
R42 


R42 
R46 
R43 
R46 


R47 


R50 


R54 
R56 
R10 
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TO DO THIS... USE SEE PAGE 
——, 
Use: ms 
| e Get absolute value of specified number ABS R41 
o MATHEMATICAL Oz 
= AND ¢ Get cosine (in radians) of the specified COS R43 im 
we ast(eye)\ (0) =as sce angle re 
FUNCTIONS © Get the constant E (2.71827) raised to the EXP R43 uo UW 
-* specified power oi Y)- 
- ¢ Get number of unused bytes in RAM FRE R44 
e Convert the specified number to an INT R45 
n integer (rounded down) 
ry e Get the ‘natural log’’ E logarithm of the LOG R47 
_ specified number : 
=. e Show contents of specified memory PEEK R48 
| address 
wi e Generate a random number RND R51 
_ e Test sign of specified number and indicate SGN R52 
ifitis +, — orO 
—, 
e Get the sine value (in radians) of specified SIN R52 
" angle 
= e Get the square root value of specified SQR R53 


number 


- e Get the tangent of specified angle TAN R55 
pom (in radians) 
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Example: 


men 4 =) A')(0) 513 


1G A=30 

20 BS="'TEST STRING 

30 PRINT “BEFORE, A = <A 
40 PRINT ‘‘AND B$ IS: °';B$ 
50 CLEAR 


60 C=66 





70 PRINT ‘AFTER, A = <A 


Clears all variables previously ex- 80 PRINT ‘‘BS 1S: ':B$ 
ecuted, resetting numeric vari- 
ables to zero and erasing the 90 PRINT ‘AND C ="':C 


contents of string variables. To 
erase variables and change 
string buffer capacity, use 
CLEAR with a numeric argument 
(e.g., CLEAR(100) clears 
variables and sets string buffer 
for 100 characters). 


SEE ALSO: RUN 


ne eee nmin 


Output: 

BEFORE, A = 55 

AND B$ IS: TEST STRING 
AFTER, A = 0 

BS IS. 


AND C = 66 





CASSETTE LOAD (CLOAD) 
copies a program from cassette 
to memory. THE NEWLY 
LOADED PROGRAM ERASES 
ANY PROGRAM OR DATA CUR- 
RENTLY IN MEMORY. To identify 
the program you wish to load, 
write its name in quote marks 
following the command. If the 
program is not identified, 
Aquarius will load the first pro- 
gram it encounters on the 
cassette. 


Program names, because they 
are written in quotes, are treated 
as string literals. Aquarius recog- 
nizes names that can have from 
1 to 6 letters, numbers and/or 
special characters (such as * or 
+). CONTINUED 1st COLUMN NEXT PAGE 





NOTE: BE SURE CASSETTE PLAYER IS PROPERLY CONNECTED TO 
AQUARIUS — DETAILS ON PAGE INTRO 7. 





PROGRAM LOAD PROCEDURE 


1. Type CLOAD and program 
name. Example: CLOAD 


‘“progrm’’ (max. 6 letters) 
Press 


2. Follow directions on screen 


e Press button on 
cassette player unit 

e Press 

3. Aquarius searches cassette 
for specified program and reports 


‘‘Skip’’ when other programs are 
encountered. When called pro- 


gram is located, displays ‘‘Found’’. 


The cassette recorder does not 
stop when “Skip”’ is displayed. 


You must press aN If you 

don’t press quickly | 
enough, you may miss reading the 
load point for the next program on 


tape. Simply back up to the load 
point and press [PLAY] 


4. ‘‘Ok’’ means program is loaded 


ARRAY LOAD PROCEDURE 


1. In Immediate Mode, dimension 
array. Example: DIM ar(100) 
Press 


2. Enter CLOAD* command with 
array name. 

Example: CLOAD* ar 

Press 


3. Press ( PLAY ) on recorder 
and follow directions on screen 


4, When array is located, ‘‘Ok’’ 
is displayed (no other messages) 


NOTE: When loading programs, 
identifying name is optional. 
When loading arrays, names (not 
in quotes) are required. 
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CASSETTE LOAD VERIFY 
(CLOAD?) verifies that the pro- 
gram loaded into memory is an 
exact duplicate of the cassette 
copy. 


CASSETTE LOAD ARRAY 
(CLOAD *) transfers an array 
from cassette to memory. The 
array must be dimensioned 
before it can be loaded. Array 


names are not enclosed in quota- 


tion marks. CLOAD* does not 

verify the accuracy of the array 
load operation. You will need to 
do that by running the program. 


The CLOAD* command must be 
followed by the array name used 
in the program. 


LOAD VERIFICATION 
PROCEDURE 


After program is loaded, you can 
have Aquarius check its work 
and re-read the tape, comparing 
it with the copy in memory. 


1. Rewind cassette to load point. 


2. Type CLOAD? “‘program name” 


3. If the two versions are identical 


Aquarius repeats the ‘Ok’ prompt; 


if there is any difference, it shows 


the message, ‘‘Bad’’. 


LOAD AND VERIFY 
COMMANDS: (Immediate Mode) 


CLOAD...load 1st program 
encountered 


CLOAD?...read 1st program en- 
countered and verify if it 
matches program in memory 


CLOAD ‘‘progrm”’...search 
cassette for ‘‘progrm’”’ and load it 
into memory 


CLOAD? ‘‘progrm’’...search for 
‘‘progrm”’ and verify if it matches 
version in memory 


CLOAD* array name...load iden- 
tified array into memory 


SEE ALSO: CSAVE, CSAVE* 





CONTINUE is used only in Im- 
mediate Mode (no line number). 
This command restarts the ex- 
ecution of a program that has 
been halted by a STOP state- 
ment. Program execution 
resumes at the first statement 
following STOP. 


nn eh eee one 





NOTE: CONT will not work if pro- 
gram break occurred during ex- 
ecution of a loop. 





During the break, it is possible to 
PRINT and reset variables in |m- 
mediate Mode before CONTinu- 
ing. Note, however, that the pro- 
gram will not continue if any er- 
rors are made in Immediate 
Mode during the break. In the 
following example, if you were to 
type in the misspelled command 
‘PRUNT A’ during one of the 
breaks, you would get a CN Error 
Message when you attempted to 
CONTinue execution. 


SEE ALSO: GOTO, STOP 


Example: 

Ww Ax 1 BaZ Ged 

20 PRINT A;**...1.M RUNNING’ 
30 STOP 

40 PRINT B;°'...AS FAST” 

590 STOP 


60 PRINT C;°'...AS | CAN!” 





Output: 


1...17M RUNNING 
Break in 30 

Ok 

CONT (RTN) 
2...AS FAST 
Break in 50 

Ok 

CONT (RTN) 
3...AS | CAN! 

Ok 








COPY writes the contents of the 
current TV screen display on the 
line printer. Carriage return, form 
feed and special non-keyboard 
characters are not sent to the 
printer. 
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CASSETTE SAVE (CSAVE) copies 
a program in memory to a 
cassette. The command must be 
followed by the program name 
enclosed in quotation marks. This 
name flags the cassette copy of 
the program, and allows 
Aquarius to identify the program 
when you want to CLOAD it. 


Program names are treated as 
String literals. Aquarius recog- 
nizes aS many as 6 characters 
and/or numbers to identify each 
program. NOTE: To verify a 
CSAVE operation, use CLOAD? 
(see page R-11). 


CASSETTE SAVE ARRAY 
(CSAVE*) transfers an array in 
memory to an cassette. The 





command must be followed by the variable which identifies the array in 


the program. 





NOTE: BE SURE CASSETTE PLAYER IS PROPERLY CONNECTED TO 
AQUARIUS — DETAILS ON PAGE INTRO 7. 





PROGRAM SAVE PROCEDURE 


1. Type CSAVE and program 
name. Example: CSAVE 
‘“orogrm’’ 


Press 


2. Follow directions on screen 
e Press ( PLAY ) and RECORD 
on cassette player unit 


e Press 


3. ‘‘Ok’’ means program is saved 


STOP CASSETTE 


ARRAY SAVE PROCEDURE 


1. Type CSAVE* and variable 
name. Example: CSAVE* AR 
Press 


2. Follow directions on screen 
e Press ( PLAY ) and RECORD 
on cassette player unit 


e Press 


3. ‘‘Ok’’ means array is saved 


STOP CASSETTE 


SAVE VERIFICATION 
PROCEDURE 


After program is saved, you can 
have Aquarius check its work 
and re-read the tape, comparing 
it with the copy in memory. 


1. Rewind cassette to load point 


2. Type CLOAD? ‘program 
name" 


3. If the two versions are identi- 
cal Aquarius repeats the ‘Ok’ 
prompt; if there is any difference, 
it shows the message, ‘Bad’. 


SAVE AND VERIFY 
COMMANDS: (!mmediate Mode) 


CSAVE ‘‘progrm’’...copy program 
in memory on cassette, under its 
name (Example: ‘‘progrm’’) 


CLOAD? ‘‘progrm’’...verify that 
both versions of ‘‘progrm”’ are 
identical (IMPORTANT: BE SURE 
TO INCLUDE QUESTION MARK, 
OR YOU WILL RELOAD THE 
PROGRAM AND LOSE THE VER- 
SION IN MEMORY!) 








number, ‘DATA’, and comma 
separators). 


CSAVE* array name...load iden- 
tified array into memory 


SEE ALSO: CLOAD, CLOAD?, 
CLOAD * 


string data must be enclosed in 
quotation marks only when they 
contain commas, colons, or lead- 
ing or trailing blanks. Otherwise, 
quotation marks are optional. 
String data may not contain 
quotation marks. 


A RESTORE statement can be 
used to change the pointer to the 
first (or another specified) DATA 
Statement. Example on next 
page. 


DATA statements are used to 
store numeric and/or string con- 
stants in a program. They must 
always have an associated READ 
statement to access these data. 


DATA statements contain 
specific data items to be READ 
by Aquarius in their line number 
sequence. Each data item is 
separated from the others by 
commas. The limit on data items 
in one DATA statement is the 
maximum length of the line (72 
characters, including the line 
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Example: 


10 PRINT ‘‘WHO'S ON THE MONEY?”’ 


20 FOR X=1 TO 10 


30 READ DES, NAS 


40 PRINT DE$;"" BILL 1S: *’;NA$ 
50 NEXT X 


60 DATA $1,WASHINGTON, $2, 
JEFFERSON 


70 DATA $5,LINCOLN,$10,HAMILTON, 


$20, JACKSON 


80 DATA $50,GRANT,$100,FRANKLIN, 


$900, McKINLEY 


90 DATA $1000,CLEVELAND,$10000, 
CHASE 


SEE ALSO: READ, RESTORE 





Comments: 


20: Indicate the number of DATA 
items, if more than one. 


30: READ statement must in- 
clude variable names to identify 
data item categories (in this 
case, DE$ = denomination, 

NA$ = name). 














The DIMENSION statement is 
used to specify the maximum 
number of elements in a numeric 
or string array, and to reserve 
memory space for the array. 


The DiMension is set by writing 
the array variable name and size 
(in parentheses) after the DIM 
statement. 


For example, DIM AR(15) allows 
the array variable ‘AR’ to contain 
the 16 numeric elements from 
AR(O) to AR(15). 


Example: 


10 DIM AR(15) 


20 FOR X=0 to 15 


30 AR(X)=X 


40 PRINT AR(X); 


90 NEXT X 





Comments: 


10: Specifies 16 numeric ele- 
ments in a single-dimensioned 
array 


30: As index variable X in- 
creases, its value becomes the 
array subscript, as X=0, X= 7, 
etc. 


Output Is a list of all array 
elements 
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A string array can be DIM- 
ensioned simply by giving it a 
string variable name. A conven- 
ient way to create string arrays 
is through the use of READ and 
DATA statements: 


Example: 


10 


20 


30 


40 
30 
60 


70 


80 


90 


DIM AR$(7) 


FOR R=0 10 7 


READ AR$(R) 


NEXT R 
PRINT ‘‘MY NAME IS ”; 
FOR P=0 10 7 


PRINT AR$(P): 


NEXT P 


DATA A,Q,U,A,R,1,U,S 





Comments: 


10: Specifies 8 string elements in 
a Single-dimensioned array 


30: The “‘read loop’’ R loads 8 
character elements in AR$ 


70: The “print loop”’ P prints the 
8 elements AR$(O) to AR$(7) 


To display array values one at a 
time, use Immediate Mode to 
PRINT AR$(O), PRINT AR$(1), etc. 





1 | | | | I ] | { 
} | i i Lt 7 | 4 1 
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Arrays can also have two dimen- 
sions. The DIM statement must 
reserve memory space for both: 





Example: 
10 DIM A$(5,1) 


“20 A$(0,0)=°'1960"':A$(0,1) = 


“KENNEDY” 


30 A$(1,0)=‘'1964"':A$(1,1) = 
JOHNSON" 


40 A$(2,0)=‘'1968"':A$(2, 1) = 
NIXON” 


50 A$(3,0)=‘'1972"':A$(3, 1) = 
““NIXON/FORD’’ 


60 A$(4,0)=°'1976'':A$(4,1) =: 
“CARTER” 


70 A$(5,0)=*'1980"':A$(5,1) = 
“REAGAN 


80 PRINT ‘‘AMERICAN PRESIDENTS 
SINCE *’:A$(0,0) 


90 PRINT ‘‘AND THEIR ELECTION 
YEARS" :PRINT 





Comments: 


10: Two dimensions are reserved 
(DIM numbers always Start at 0, 
not 1), the 1st with 6 elements, 
the 2nd with 2 elements 


20-70: Array values for every 
String element 


Lu 
O 
| 
Lil 
Cc 
Lil 
LL 
Lil 
co 


SECTION 








R20 


100 FOR X=0 T0 5 


110 PRINT A$(X,0);TAB(8)A$(X, 1) 


120 PRINT 


130 NEXT X 


100: The FOR-NEXT index 
counter uses 1st dimension’s 
values (0-5) 





} 


} 


} 





The END statement terminates 
program execution. Its use is op- 
tional, since Aquarius ends the 
program when there are no more 
statements to be executed. END 
does not necessarily have to ap- 
pear in the highest-numbered 
program line. It can be a branch- 
ing statement destination. Or it 
can be inserted, as in the exam- 
ple, to prevent continuous execu- 
tion when ail program steps are 
completed. 


After being ENDed, the program 
can be re-executed with RUN, 
not CONT. 


Example: 


10 PRINT “WHO'S ON THE MONEY?’ 


20 FOR QU=1 to 10 

30 READ DE$, NA$ 

40 PRINT DE$,‘’---"’ 

90 INPUT ANS 

60 IF AN$=NA$ goto 130 

70 PRINT ‘‘WRONG. IT’S °';NAG 
80 WR=WR+1 

90 NEXT QU 


100 PRINT ‘YOU SCORED’':100 
* RI/(Ri + WR) 


110 PRINT ‘° PER CENT’ 
120 END 


130 RI=RI+1 


140 PRINT “RIGHT!” 





150 GOTO 90 

160 DATA $1,WASHINGTON, $2, 
JEFFERSON ,$5, LINCOLN,$10, 
HAMILTON 

170 DATA $20, JACKSON $50 
GRANT,$100,FRANKLIN,$500, 
MCKINLEY 


180 DATA $1000,CLEVELAND, 
$10000, CHASE 


Variables: 

QU = question number 

DE$ = denomination (in DATA) 
NAS = name (in DATA) 

AN$ = user's answer 


WR = number of wrong 
answers 


RI = number of right answers 
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FOR...NEXT 


FOR...NEXT is a two-part state- 
ment which repeats enclosed 
program steps a specified 


number of times. The FOR state- 


ment contains the starting value, 
‘TO’ the ending value and incre- 
ment (default is 1). If the incre- 
ment is other than 1 or if values 
decrement, a STEP clause is re- 
quired. Starting and ending 
values can be numeric variables 
and/or expressions (FOR Z=T 
TO Tx 4). 


The NEXT statement branches 
Aquarius back to its associated 
FOR, until all specified loops 
have been executed. FOR and 
NEXT statements are related to 
each other by assignment of the 
same numeric ‘‘index’’ variable. 








Examples: 


epeal fun tion 
| | KH X - 3 

PRIN 
30 
10 C CX Vdl Ewe 
fives 

|4 

20) PRINT CHRS(X 
30 NEXT X 
(To add time-delay es) 
1) FOR Y 14 TO 
c L '=0 TO 200 STEP 
14 NEXT T 


20 PRINT CHRS(X) 


30 NEXT X 





Comments: 


This loop fills the screen with the 
equal sign character by repeating 
it 912 times (38 columns by 24 
rows) 


This loop uses the incrementing 
value of index variable ‘xX’ for 
character codes 14-255 


Same output as previous exam- 
ple, but now Aquarius counts the 
even numbers from 0 to 200 
before printing each character. 











Example: Comments: 








10 GOTO 60 10: GOTO prevents start of sub- 0 ; 
routine until variable ‘A’ is input > é ; 
Lu — | 
20 REM DISPLAY CHARACTER 20: Labels subroutine start oc F- 
SUBR Thos 
rae 
Li ZY) | 
RIN | GCHRS(A) oc | 
GOSUB, like GOTO, is an uncon- 50 RETURN 50: Returns contro! to main 
ditional branch. The first line program 
number of the subroutine must 
follow GOSUB. The subroutine is 60 PRINT ‘ENTER A NUMBER elect! 
terminated with a RETURN state- FROM": a) 
ment, which gives program con- A ee So 
trol to the first statement follow- 70 INPUT ‘‘ 0 TO 255: ":A pees : 
ing the GOSUB. Multiple ce ee 
RETURN statements with condi- 80 PRINT ‘THIS IS THI ee 
tions (for example, IF A> B CHARACTER: | 
THEN RETURN) can be used in 
a subroutine to transfer control 90 GOSUB 20 : 
back to the relevant GOSUB. oe ES SES recat) 
100 GOTO 60 100: Unconditional branch to do ee 
A subroutine can be called any another input. hs ees 


number of times in a program, 
and may be called from another 
subroutine. 


SEE ALSO: RETURN, ON... 
CONTINUED NEXT PAGE GOSUB 





“R24 





Although subroutines may appear 
anywhere in a program, it is a 
good practice to separate them 
in different line number groups 
and to identify each one with a 
REM statement. 


To prevent unintended execution 
of a subroutine, it is a good idea 
to precede it with a STOP, END 
or GOTO statement so that the 
only access is controlled by a 
GOSUB. 





GOTO (or GO TO) is used to 
branch to any specified program 
line unconditionally. It can also 
be used to re-start the program 
after a STOP, END, or 


(CTL }{_C ] termination. 


Example: 


10 


20 


30 


40 


GOTO 60 
PRINT “is: 
GOTO 80 


PRINT °‘branching 


0 END 


60 PRINT ‘This’; 


PRINT ‘‘ unconditional °: 


) GOTO 40 


SEE ALSO: ON...GOTO 





Output: 
(Program RUN) 


This is unconditional branching 


(Immediate Mode: GOTO 80) 
unconditional branching 


If line 50 is deleted, the program 
is in an “endless loop’’. Press 


[ CTL }{ C ] to stop it. 








Examples of ‘IF’ Conditions 


IFA>B 

IF... THEN IF A+B<Cx3 
IFA*B=C 

IF A$ = ‘‘yes”’ 


on Note: String data must be en- 
The IF statement specifies a closed in quotes for ‘IF.. THEN’ 
relational or logical condition and comparisons. 
a THEN clause specifies some 
program instruction if the condi- 
tion is True. When the IF condi- 
tion is False, program control 
proceeds to the following 
statement. 


The second clause of the IF 
statement starts with THEN, 
which must precede all resulting 
operations (optional for GOTO). 


SEE ALSO: ON...GOTO, ON... 
GOSUB 





Examples of ‘THEN’ 
instructions 


THEN PRINT ‘‘A !S LARGER” 
GOTO 100 

THEN C=C+1 

THEN GOSUB 200 

Note: Any BASIC statement may 


be used as the result of a True 
condition. 





O 
eo 
Lud 
cc 
LL 
LL. 
Lu 
oc 


z= 
eo) 
— 
O 
Lu 
VY). 





——— 





A26 





INPUT allows the Aquarius user 
to enter data while the program 
waits. INPUT stops program ex- 
ecution until the user types in 


data on the keyboard and 
presses | RTN J]. 


Data entered when INPUT is be- 
ing executed are assigned to the 
variable(s) named in the state- 
ment. Optionally, you may 
specify a constant ‘‘prompt’’ to 
tell the user what is being IN- 
PUT. Whether you include a 
prompt or not, Aquarius auto- 
matically displays one or two 
question marks (depending on 
how many input variables). 


When you include a prompting 
constant and multiple variables, 





the prompt and one question mark are shown for the first input item. 
For subsequent variables, only “??’ is shown. Values are assigned to 
the variables in the INPUT list, from left to right. 


If non-numeric characters are input when a numeric variable is ex- 
pected, Aquarius displays the REDO FROM START message and waits 


for input in the correct form. 





Example: 


10 INPUT “Hi, what's your 
name ' ;N$ 


20 INPUT ‘How old are you 


30 PRINT ‘‘Give me first names of 


40 INPUT ‘‘3 friends '':A$,B$,C$ 
50 INPUT *'---and their ages -':D,E,F 


60 PRINT ‘‘The average age of ’':A$ 


70 PRINT ‘‘ and *':B$:‘ and ’':C$ 
80 PRINT °° and you, © .N$;"’. Is 


90 PRINT (AG+D+E+F)/4; ‘years 


Comment: 


10; Prompt and one string 
variable 


20: Prompt and one numeric 
variable 


40-50: Multiple variables (use 
comma separators) 


60-90: Output using all data 
entered 








LET is used to assign numeric 
values to numeric variables, and 
characters to string variables. 


String data must be assigned str- 


ing variable names; numeric ex- 
pressions must be named 
numeric variables. The keyword 
LET is optional, because 
Aquarius understands that an 
equal sign means the same 
thing. 


10 LET A=5 is the same as... 
10 A=5 


20 LET A$=‘‘Yes’”’ is the same 
as...20 A$ = ‘‘Yes’’ 


LIST displays the program cur- 
rently in memory on the TV 
screen. It allows you to list all or 
part of the program, one screen 
at a time. Press any key except 


| CTL |, | SHIFT | or to ad- 


vance one screen. 


1. To LIST entire program, use: 
LIST 


2. To LIST entire program, start- 
ing with a specific line number, 
add the starting line number 
(LIST 80) 


3. While LIST is being executed, 
you have these options: 
1) CANCEL LISTING: Press 
and at same time 


a NY ATT IAN, AS TR Tin Nl iE had IT RA I LPO Pe Le Re 5 UR RT ee RE 


(2) INTERRUPT LISTING: 
Press and | STPLST 


at same time 


(3) RESUME LISTING AFTER 
INTERRUPT: Press and 


STPLST | at same time — or 
any key except (alone), 
SHIFT | or 


SEE ALSO: LLIST 
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LLIST writes a listing of the pro- 
gram in memory on the printer. 


1. To print a listing of entire pro- 
gram, use LLIST 


2. To print a listing starting after 
the first line of the program, use 
LLIST followed by the starting 
line number; for example, 

LLIST 80 


3. Unlike the LIST command, 
[ett }{C ] and [CTL }LS J have 
no effect on LLIST. To cancel a 
LLIST command, turn the printer 
off until the operation is 
completed. 


SEE ALSO: LIST 


LPRINT 


LPRINT writes specified data on 
the printer. It is used the same 
way as the PRINT statement. 
Example: 

LPRINT A$:B$;CHR§(10) 


or 10 LPRINT A$;B$;CHR$(10) 


SEE ALSO: PRINT 


NEW is used to erase all con- 
tents of memory. NOTE: BE 
SURE, BEFORE ENTERING THIS 
COMMAND, THAT YOU REALLY 
WANT TO ERASE ALL PRO- 
GRAM LINES AND DATA! 
Before starting a completely new 
program it’s a good idea to use 
NEW, to delete possible un- 
wanted statements that might not 
be replaced by line-to-line re- 
writing. 


If NEW is used in Programmed 
Mode, it will cause the program 
to ‘‘self-destruct’’. In Immediate 
Mode, NEW can be useful to 
clear out all memory addresses 
to test sizes of planned arrays. 








In this example, you could quickly determine that arrays A and B re- 


quire 584 bytes of memory (1731 minus 1147): 


Example: Output: 
NEW NEW 
PRINT FRE(0) Ok 
DIM A(10,10), B(20) PRINT FRE(Q) 
PRINT FRE(0) 1731 
Ok 


DIM A(10,10), B(20) 
Ok 
PRINT FRE(O) 


1147 


SEE ALSO: CLEAR 





ON is always used as a prefix to 


one of the branching statements: 


GOSUB or GOTO. It branches 
program control to a list of pro- 


gram lines or subroutines, select- 


ing the destination based on the 
value of specified numeric 
variables. 


The format is: ON expression 
GOTO (or GOSUB) DE1,DE2. If 
the lower expression is selected, 
branch goes to the first destina- 
tion (DE1). If the higher expres- 
sion is selected, the branch is to 
DE2. 


See example on next page. 
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Example: Comment: Example: (Cont.) 
10 PRINT‘’'1: CONVERT TO 110 F=(9/5*TE) +32 
FAHRENHEIT’’ 

120 PRINT'‘FAHRENHEIT DEG. ='':F 
20 PRINT''2: CONVERT TO 
CELSIUS”’ 130 RETURN 
30 PRINT'’3: END PROGRAM NOW"? 200 REM Subroutine for Celsius 
40 INPUT’'WHAT’S YOUR 210 C=5/9*(TE-32) 
CHOICE’’:CH 

220 PRINT'‘CELSIUS DEG. ='’:C 
50 IF CH > 2 GOTO 999 

230 RETURN 
60 IF CH < 1 GOTO 10 

999 END 


70 INPUT''TEMPERATURE {S:"°;TE 


80 ON CH GOSUB 100,200 80: At this point in the program, 

. CH equals either 7 or 2. If it is 7, 
the GOSUB branch is to the fst 
destination in the list (100). If 
CH = 2, the branch is to the 2nd 
destination. There could be as 

-many destinations as there are 
variable value possibilities. 


90 PRINT:GOTO 10 


100 REM Subroutine for Fahrenheit 


. 








POKE stores a numeric value in 
a specified memory location. 
Usually, POKE is used to display 
special characters and produce 
colors on the screen. To display 
the code of a character stored in 
a specific location, use PEEK. 


POKE is followed by two specifi- 
cations: a memory address and a 
character code number or value 
in the range from 0 through 255. 


SEE ALSO: PEEK 


Examples: 
(TO PRODUCE COLOR) 


20 MA=12328+ 1024 


nr / . Ths 
30 FOR X=0 10 9 
40 FOR Y=0 JT0 23 


—_- 


90 POKE MA+X+Y*40,C 


60 NEXT Y,X 


(TO DISPLAY CHARACTERS) 


cm 
nd 


PRINT CHR$(11) 


19299 


yf) 8) 7 
} r= | “ ILO 


Ta qn) /_ 1’) TN ORE 
30 FOR X=0 [0 255 


40 POKE P+X,.X 


50 NEXT X 


60 2:7:2:2:2:9 





Comments: 


10: Set color code (red) 


20; Set memory address to color 
section 


30: X=columns 0-5 
40: Y=rows 0-23 


50: POKE produces color in left 6 
columns 


10: First clear screen 
20: P = starting address 
30: Cycles through character set 


40: POKEs addresses from 
12328 through 12583 


60: Blank line spacing keeps 
cursor and prompt from being 
Superimposed on characters 





REFERENCE 


_SECTION 














R32 


PRESET 


PSET 





PRESET erases a graphic block 
on the screen that was drawn by 
a PSET statement. 


PSET and PRESET divide the 
screen into a grid consisting of 
80 columns and 72 rows. This 
graphics grid can be thought of 
as being superimposed on the 
character grid, which consists of 
39 columns and 24 rows. Each 
character position is divided into 
6 small rectangles — three verti- 
cal and 2 horizontal. All of these 
smalier graphics blocks can be 
independently ‘‘set’’ (with PSET 
or erased (with PRESET). 


The PRESET statement must be followed by two specifications: the col- 
umn location (from 0 to 79), and the row (from 0 to 71). 
The POINT statement is used to determine whether a specific block is 


set or not set. 





Example: 


10 PSET (0,0) 


20 FOR |=1 TO 500:NEXT | 


30 PRESET (0,0) 


SEE ALSO: POINT 


SEE ALSO: PEEK 


Comments: 


10: Sets ‘home position’ block 
— column 0, row 0 


20; Delay loop allows you to see 
block before it's erased. 


30: Erases ‘‘home position” 
block — column 0, row 0 





PRINT can be used either in Im- 
mediate or Programmed Mode. 
In Immediate Mode, it is a useful 
debugging aid to display the 
values of numeric variables and 
the contents of string variables 
Stored in memory. 


In either mode, PRINT displays 
following constants and vari- 
ables. Each element of the line is 
separated by a comma or semi- 
colon. Output is on the TV 
screen. 


Another use for this statement is 
to ‘print’? a blank line; in other 
words, to skip a line. 





PRINT can be abbreviated with a question mark. Aquarius will show the 
entire word when the program is listed. 





Example: Output: 


10 PRINT ‘‘TEST RUN FOR TEST RUN FOR ‘PRINT’ 


20 PRINT ‘‘ ‘PRINT’ °’ 

30 PRINT A+B=9 
40 A=5:B=4 

50 ?°‘A+B="':A+B 

60 2:3 END DEMO 


70 PRINT ‘‘END DEMQ™ 


80 END 





Note: To indicate some form of quotes to emphasize characters be- 
tween quotation marks, use apostrophes. 





SEE ALSO: LPRINT 
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The READ statement is used to 
read items from DATA state- 
ments and assign that data to a 
variable. Every time READ ex- 
ecutes, one data item is read. A 
pointer moves to the next data 
item and waits for READ to be 
executed again. 


DATA statements may appear 
anywhere in a program. The first 
such statement represents the 
Start of data. Each subsequent 
DATA statement is considered to 
be a continuation. 





If a READ statement does not 
assign all data items to variables, 
the next READ statement assigns 
following data items. If there are 
no more READ statements, the 
leftover DATA is unused. 


An out-of-data condition (OD Er- 
ror) occurs when the last value 
has been assigned and a READ 
statement attempts to assign 
another value to a variable. A 
RESTORE statement resets the 
pointer to the first DATA state- 
ment in the program. 


The type of variables in a READ 
Statement must match the data 
type of corresponding items in 
DATA statements. 


Refer to DATA for a program 
example. 


SEE ALSO: DATA, RESTORE 








REM is used to insert comments 
in a program. These comments 
are displayed when the program 
is LISTed, not when it is RUN. 
The comments do not have to be 
enclosed in quotation marks. 


Even though REM statements are 
not displayed during program ex- 
ecution, their line numbers can 
be branching destinations for 
GOSUB and GOTO instructions. 


It is a good programming practice to use REM statements for memo 
purposes, to identify subroutines and key program operations, provide 
descriptions of variables and so forth. However, if memory space is 
limited, REM statements should be deleted to free some capacity for 


program essentials. 





Example: 

10 REM THIS IS A COMMENT LINE 
20 PRINT ‘THIS IS A PRINT LINE 
30 C=0+1 

40 IF C< 4 GOTO 10 


50 END 


Output: 


THIS IS A PRINT LINE 
THIS IS A PRINT LINE 


THIS IS A PRINT LINE 
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RESTORE allows data to be re- 
read from a specified line 
number. If no line number is 
specified, all data in the program 
is re-read. 


After an unspecific RESTORE 
Statement (written as simply 
RESTORE) is executed, the next 
READ statement accesses the 
first item in the program's first 
DATA statement. If RESTORE 


specifies a line number (example: 


RESTORE 150), the next READ 
Statement accesses the first 
DATA item in that line. 


lf a DATA statement does not ap- 


pear on the specified line, the 
READ statement accesses the 
first item in the next DATA state- 
ment. 


Example: 

10 X=0:Y=6 

20 FOR R=X T0 Y 

30 READ DS$ 

40 PRINT DS$;°° 

90 NEXT R 

60 IF R > 13 THEN END 
70 PRINT CHR$(13) 


80 RESTORE 180 


90 FOR R=1 10 3 


100 READ DS$ 


110 PRINT DS$;"° 
120 NEXT R 
130 PRINT CHR$(13) 


140 RESTORE 


Comments: 


20-50: Reads and prints all data 


80: Moves pointer to 1st data 
item in 180 


100: Next READ statement starts 
at 180 


140: Moves pointer to Start of all 
data 





—_ 


150 X=7:Y=13 
160 GOTO 20 
170 DATA One,two, three, four 


180 DATA five,six,seven 


SEE ALSO: DATA, READ 





160: Repeats READ loop 


Output: 
One two three four five six seven 
five six seven 


One two three four five six seven 


REFERENCE 
SECTION 
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RETURN 





RETURN is the branching state- 
ment that transfers program con- 
trol from a subroutine back to 
the main program. The destina- 
tion of the RETURN branch is the 
program statement immediately 
following the GOSUB statement 
that called the subroutine. A sub- 
routine may contain multiple 
RETURN statements if they have 
different conditions. 


Examples: Comments: 


10 GOSUB 40 Sequence of line execution: 
20 PRINT ‘““SUBROUTINE 10, 40, 50, 20, 30 

RETURNS HERE 

30 END 

40 PRINT “SUBROUTINE 


10 GOSUB 100 Sequence of line execution: 
0 PRINT ‘‘SUBROUTINE 100 10, 100, 170, 200, 210, 120, 
RETURN 130, 20, 30 

30 END 

100 PRINT ‘‘SUBROUTINE 100 


120 PRINT ‘‘SUBROUTINE 200 
RETURN’ 
3.) RETURN 
200 PRINT ‘‘SUBROUTINE 200" This program illustrates how one 
subroutine can be called from 
210 RETURN another subroutine. 








RUN starts execution of the pro- 
gram in memory at the lowest 
line number. You can begin ex- 
ecution at a higher line number 
by adding the starting line to the 
command (e.g., RUN 120). 


When RUN is entered, all vari- 
ables are set to zero or blank. To 
preserve variable contents after 
a STOP interruption, use CONT 
or GOTO to restart execution. 


30 PRINT “RUN COMMAND 





Program Display: 
Ok 
RUN 


THIS IS A TEST FOR RUN 
COMMAND 

Ok 

RUN 20 

A TEST FOR RUN COMMAND 
Ok 








SOUND generates a tone. The 
SOUND statement must be 
followed by two specifications, 
written in parentheses and 
separated by a comma: duration 
and tone. 


The generated tone is expressed 
as a numeric variable, constant, 
or expression. A low value, such 
as 10, gives a high-frequency 
tone. A high value, such as 500, 
gives a low-frequency tone. 


Duration is the duration of the 
tone, and can be set with a 
numeric variable, constant or ex- 
pression. Usually, duration values 
used are in the range from 5 to 
500. The higher the’ value, the 
longer the tone lasts. The actual 
duration of the tone increases 
when high values are used for 
Tone, even though Duration 
values remain the same. 
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Example: 
10 For X=1 108 


20 SOUND(50,80) 


30 SOQUND(80,50) 


40 NEXT X 


Comments: 


20: Specify high-pitch tone (50), 
duration 80 


30: Specify a slightly lower tone 
(80), duration 50 


This short program demonstrates 
an oscillating tone signal. 





STOP halts program execution. 
When STOP is executed, 
Aquarius displays a Break 
message indicating the last pro- 
gram line done. The program run 
may be resumed by entering 
CONT or GOTO, unless an Im- 
mediate Mode error occurs dur- 
ing the break. 


See CONT for a program exam- 
ple using STOP. 


SEE ALSO: GOTO 


FUNCTIONS 





Aquarius provides three categor- 
ies of functions: NUMERIC, 
STRING and SYSTEM. 


NUMERIC functions return 
numeric values that are usually 
employed in mathematical and 
trigonometric calculations. 





STRING functions provide infor- STRING 
mation about the contents of 


character strings. ASC LEFT$ RIGHT$ 
CHR$ LEN STR$ 
SYSTEM functions provide infor- INKEY$ MID$ VAL 
mation about memory availability 
and contents, and control the SYSTEM 
cursor location. 
FRE POINT SPC 
NUMERIC PEEK POS TAB 
ABS LOG SQR 
COS RND TAN 
EXP SGN USR 
INT SIN 








Returns the absolute value of a number (the number alone, without a 
plus or minus sign). The value returned is always positive. 


Format: 
ABS(ex) 
ex = an arithmetic expression, numeric constant or variable 
Example: Result: 
X =ABS( —- 65) 65 


PRINT X 
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Returns the ASCII character code for the first character in a 


string variable. 


Format: 
ASC(SVS) 
SV$ = a string variable 
Example: Result: 
SV$ =''XYZ"’ PRINT 88 
ASC(SV$) OF 
PRINT ASC(°°X’’) 88 
Special Function Code Function 
CHRS§(7) Ring bell 
CHR&(8) Delete character left of cursor 
CHR$(10) Carriage return may be used in 
same PRINT statement with data 
CHR&(11) Clear screen, return cursor to 
home position 
Displays the character specified CHRS(13) Carriage return, ignored when 


from the character set numbered 
from 0 to 225. 


used in same PRINT statement 
as data 


Se ee 


NOTE: ONLY CODES 10 AND 13 ARE CONTROL FUNCTIONS WITH 


LLIST. 


NN eee neem 








Format: Example: Result: 
, AIT INT/RGE) Lud 
ne CHR&§(ex) PRINT CHR$(65) A Q) 
ex = an arithmetic expression, > =< 
_ numeric constant or variable Lu eo) 
(range: 0 to 255) oe 
Li Li 
Returns the cosine (in radians) of the argument. co 
aa Format: 
= COS(ex) 
ex = an arithmetic exoression, numeric constant or variable 
_ Example: | Result: 
= Pl=3.14159 1 


PRINT COS(2* Pl) 





Returns the value of the mathematical constant e (2.71827), raised to 
the power of the argument. The argument cannot be larger than 
87.3365, or the result will be the Overflow Error: ?OV. 


Format: 


EXP(ex) 
ex = an arithmetic expression, numeric constant or variable 


Example: Result: 
PRINT EXP(3) 20.0855 
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INKEY$ 











Returns the number of available bytes (characters) in memory. When 
the argument is numeric, the result is the amount of memory not being 
used by BASIC. When the argument is a string, the result is the total 
number of string characters you can use in Immediate or Programmed 
mode. 


Format: 

FRE(ex) 
ex = an arithmetic or string expression, or 
a numeric or string constant, or 
a numeric or string variable 

Example: Result: 


T FRE(X 1731 (no programs in memory) 


PRINT FRE(‘'A’’) 50 (no programs in memory) 





KEY INPUT reads a keyboard character while the program is running. 
Unlike INPUT, INKEY$ does not stop program execution and wait for 
| RTN | to be pressed. Aquarius keeps cycling until it receives the 
specified message from the keyboard. It assigns that single-key 
message to a string variable. 


INKEY$ has value in certain types of game routines when you want 
Aquarius to instantly recognize keyboard input without stopping pro- 
gram execution. 





seseesesesesesesesesesesesesesesseeses S 





Example: 


10 
20 
30 
40 


530 


60 


70 
80 


PRINT CHR$(11) 

PRINT ‘‘PRESS ANY KEY” 
X$ = INKEYS 

IF X$='"' "GOTO 30 


PRINT ‘‘YOU JUST PRESSED °';X$ 


PRINT ‘‘PRESS *"';X$;"* AGAIN TO 
RESTART.”’ 


IF INKEY$=X$ GOTO 10 
GOTO 70 





Output: 

PRESS ANY KEY 

YOU JUST PRESSED (k) 

PRESS (k) AGAIN TO RESTART 
Note: These keys don't work 
with Inkey$: | CTL }| SHIFT |. 
These keys work, but do not get 
printed on screen: 


CRTN }{-'. 
Do not use [ RST ]. 





Returns the integer (whole number) value of the argument. In the case 
of negative numbers with decimals, the integer result will be rounded to 
a number less than the value of the argument. 


Format: 
INT(ex) 


Example: 


PRINT INT(24.66) 


PRINT INT(— 24.66) 


ex = an arithmetic expression, numeric constant or variable 


Result: 
24 
— 25 
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Returns a specified number of characters from the left end of a 
character string. Character positions are numbered from left to right, 
Starting with 1. 


Format: 


LEFT$(sv$, n) 
sv$ = the same of the string variable 
nm = anumeric constant, variable or expression indicating number 
of characters to be returned 





Example: Result: 
SV$ =‘ ‘AQUARIUS AQU 
PRINT LEFT$(SV$,3) 


Note: /f string is created by a STR$ operation, then it has a leading 
blank as leftmost character. 








Format: 
LEN(sv$) 

SV$ = the name of the string variable 
Example: Result: 
SV$= ‘MATTEL ELECTRONICS 18 


PRINT LEN(SV$) 
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Returns the number of characters, including blanks, in a character string. 








Returns the natural logarithm (e) of the argument. The argument must 
be greater than zero. 


Format: 
LOG(ex) 
ex = an arithmetic expression, numeric constant or variable 
Example: Result: 
PRINT LOG(9) 2ARe2 





Returns a specified series of characters from the middle of a character 
string. Character positions in a string are numbered from left to right, 
starting with 1. 


Format: 

MID&sv$,fc,n) 
sv$ = the name of the string variable 
fc = position of the first character to be returned. May be an 
arithmetic expression, or numeric constant or variable 


n = the number of characters to be retrieved: can be an arithmetic 
expression, or numeric constant or variable 


Example: Result: 
SV$= ‘AQUARIUS’ UARI 
PRINT MID$(SV$,3,4) 


Note: If string is created by a STR$ operation, then it has a leading 
blank as leftmost character. 
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Returns the code of the specified character stored in the character 
RAM matrix, or the code of the specified color stored in the color RAM 
matrix. 


In the example, the first step is to POKE the letter A (whose code is 65) 
into the home position of the screen. Then PEEK indicates the code of 
that character. Note that characters, but not colors, scroll off the top of 
the screen after it is filled. 
Format: 
PEEK(nc) 

nc = an arithmetic expression, 

numeric constant or variable 
Example: Result: 
10 CHRS$(11) 


20 POKE 12328,65 


30 PRINT PEEK (12328) 








The POINT function is used to 
determine if a specified square 
of the graphics grid has been 
‘‘set’’. POINT produces one of 
two answers: ‘1’ if the specified 
square is set, ‘O’ if it is not set. 


The PSET and PRESET state- 
ments divide the screen into a 
grid of 80 columns and 72 rows. 
Each square can be inde- 
pendently PSET or PRESET (to 
be filled with a color, for 
example). 


tn order to test any of these 
squares, POINT must include, in 
following parentheses, column 
and row locations. 


Example: 
10 PRINT CHR$(11) 


20 PSET(0,0):PSET(0, 1) 


30 PRINT “SQUARE 0,0 IS:°; 
40 PRINT POINT (0,0) 
50 PRINT ‘SQUARE 0,1 IS:"; 
60 PRINT POINT (0,1) 


70 INPUT X 


80 PRESET (0,1) 
90 PRINT ‘‘NOW SQUARE 0,1 1S:"; 


100 PRINT POINT (0,1) 





Comments: 
10: Clear screen first 
20; Set squares 0,0 and 0,7 


(Column 0, Row 0 and Column 0, 
Row 17) 


40; Report POINT test of 0,0 


60: Report POINT test of 0,7 


70: Causes pause until input is 
entered, for time to see result 


80: Unset square 0,1 


100: Report current state of 
block 0,1 
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Returns the current column position of the cursor. The leftmost column 
is number zero. 


Format: 

POS(ex) 
ex = a numeric constant or variable, or a string constant or variable 
(a ‘‘dummy argument’’ — can be any value) 

Example: Result: 

10 PRINT’‘CURSOR IN CURSOR IN COLUMN 16 


COLUMN'’;POS(0) 


Returns the specified series of characters from the right end of a 
character string. Character positions are numbered from left to right, 
Starting with 1. 


Format: 


RIGHTS(SV$,n) 
SV$ = the name of the string variable 
n = arithmetic expression, numeric constant or variable specifying 
number of characters to be returned 


Example: Result: 
SV$ = ‘AQUARIUS RIUS 


PRINT RIGHT$(SV$,4) 


Note: If string is created by a STR$ operation, then it has a leading 
blank as leftmost character. 








“a Generates a random number. Used alone, the RND function produces 
a 6-digit number between zero and one (example: .245121). To get AT 
_ whole random numbers, use RND and INT together. Os 
‘a Format: ie | 
= Cc 
rn * RND (da) + mi Lid 
— rn = range of possible random numbers (arithmetic expression, | +f 
numeric constant or variable). fe 
~é da = dummy argument; can be any number or expression, but 
oe (0) repeats last random number generated 
(1) generates a new number each time 
_ mi = smallest number to be generated (numeric expression, constant 
or variable) 
ee Examples: Results: (num exp, const or 
variable) 4 
een PRINT RND(1) A random number between 1 | 
and 0...such as: .762304 . 
on 
PRINT 6*RND(1)+1 A random number between 6 | | 
—_ and 1...such as: 2.47073 | 
" PRINT INT(25*RND(1) + 12) A random integer between 36 | 
= and 12...such as: 22 o 
= 10 FOR X=1 TO 10 Random integers between 6 and 
rat 20 RN=INT(6*RND(1) + 1) 1..such as: 2432526316 
30 PRINT RN: 


~— 40 NEXT X 





Returns the sign of the argument, as: 


1 if the argument is positive 
0 if the argument is zero 
—1 if the argument is negative 


Format: 
SGN(ex) 
ex = an arithmetic expression, numeric constant or variable 
Examples: Result: 
PRINT SGN(29);SGN(0):SGN(— 66 io =) 


Returns the sine (in radians) of the argument. 





Format: 
SIN(ex) 
ex = an arithmetic expression, numeric constant or variable 
Examples: Result: 
Pl=3.14159 1 


PRINT SIN(PI/2 
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inserts specified number of blanks in a PRINT line. If too many spaces 
are inserted to allow PRINT output to fit on one line, the remaining 





pad spaces are inserted on the next line. 5 = 
=O 
= Format: Lu = 
cr 
- SPC(ex) uO 
om ex = an arithmetic expression, numeric constant or variable in the _ Tp) 
range 0 to 255 rae 
Examples: Result: 
_ PRINT’*PLAY’’:SPC(8) PLAY INTELLIVISION 
‘INTELLIVISION 
LPRINT* PLAY; SPC(3) PLAY INTELLIVISION 
- “INTELLIVISION 
Returns the square root of the argument. 
Format: 
— SQR(ex) 
ex = an arithmetic expression, numeric constant or variable 
— (cannot be negative) 
“ Example: Result: 





PRINT SQR(39) 6.245 


Converts a number into a character string. Note: STR$ is the inverse of —_ 
VAL. Can be used to change a numeric value into a string, so it can 
then be used with any string function. Note: there will be a leading 





blank for positive numbers). = 
Format: _ 
STR&(ex) -_ 

ex = an arithmetic expression, numeric constant or variable — 
Examples: Result: — 
10 A=176 17 (preceded by blank) e 
20 A$=STRSA) as 


30 PRINT LEFTS(A$,3) 
Te nc ET reese ee eee eee ee see ee eee esse ees ee cece ceeee eee eee ee eee ee eee eeeee eee eee een SS a 


Advances cursor to a specified column. Data is printed in the next — 
available print positions. 


Columns are numbered from 0 (left margin) to 39 (right margin). If the 
position specified in the TAB argument overflows the right-margin, the 
remaining spaces are inserted on following line. _ 


Format: 





TAB(ex) 
ex = an arithmetic expression, numeric constant or variable in the 
range 0 to 255 
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Examples: Result: 





yas PRINT‘: AQUARIUS" ’:TAB(12) AQUARIUS LOVES YOU iS 
“LOVES YOU" oe 

- 7 ti 2 
10 FOR X=2 TO 10 STEP 2 AQUARIUS ck 

‘*. AQUARIUS TTS; 

3 20 PRINT TAB(X)'*AQUARIUS AQUARIUS LD 

AQUARIUS fe 

— 30 NEXT X AQUARIUS | 

- To move cursor down the screen a specified number of lines (L) to a 

a specified TAB position (P), use this formula: TAB(L* 38 + P) 





Returns the tangent (in radians) of the argument. | 





Format: | 
" TAN(ex) | 
é. ex = an arithmetic expression, numeric constant or variable | 
" Examples: Result: | 
8 PRINT TAN(45) 1.61977 : 














Branches to a user-created machine code subroutine. Machine code 
has certain advantages over BASIC, in terms of execution speed and 
memory requirements. It is not as easy to learn as BASIC, and it is 
beyond the scope of this guide. You may want to study machine code 
and learn it use it in BASIC program subroutines to make your pro- 
grams more efficient and responsive. 


Only one USR function may be defined in memory. The starting 
memory address of machine code subroutines are stored in addresses 
14340 and 14341. 


tm tee ee ee rr 





Converts a character string into 
a numeric value. VAL is the in- 
verse of STR$. The string must 
contain valid numbers. If string 
contains a plus or minus sign, it 
must precede numbers. The 
function returns a value of zero if 
the first character of the string is 
not a number or valid sign. 


Format: 
VAL(SV$) 

SV$ = name of the string variable containing the character string 
Examples: Result: 
10 INPUT SV$ ? —99 
20 PRINT VAL(SV$) — 99 
30 GOTO 1 ?31- 

31 

? xyZ 
0 
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PROGRAMMING 


“BUGS” AND 
ERROR MESSAGES 





Aquarius detects several different 
types of errors that keep pro- 
grams from being executed. 
When an error is encountered, 
the program stops running and 
an Error Message appears. 
These messages indicate the 
program line number where the 
‘bug’ is found, together with an 
abbreviation of the general error 


type. 


Aquarius does NOT find logic 
flaws that affect program results. 
It does act as an editor to point 
you to any lines in your program 
where you made a “‘basic”’ 
mistake. 


APPENDIX 





Errors of syntax (primarily spell- 
ing and punctuation) are com- 
mon types. As you gain more ex- 
perience with Aquarius and the 
rules of BASIC you should have 
fewer and fewer syntax errors. 
Use the key with specific 
instruction keys as much as 
possible, to reduce the chance of 
spelling and typing errors. 














Logical mistakes (such as 
branching to the wrong line, cail- 
ing the wrong subroutine, forget- 
‘ting arithmetic priorities, etc.) will 
be apparent when you test your 
programs against known-to-be- 
correct results. Use the im- 
mediate Mode to double-check 
calculations and current variable 
values at various stages in the 
program. 


When you correct an error or 
change the program in any way, 
re-start execution at the begin- 
ning with the RUN command. 


BS BAD SUBSCRIPT. The sub- 
script used to reference an array 
is inconsistent with the dimen- 
sion range specified. 


CN CAN'T CONTINUE. After a 


STOP statement halts a program, 


CONT can be entered in Im- 
mediate Mode to restart execu- 
tion. After an END halt, GOTO 
will restart at a specified line. 
The CN message indicates that 


one or more of the following con- 


ditions prevent execution from 
continuing: 


e An Immediate Mode error 
occurred during the break 


e A program is not currently in 
memory 


e Program was halted because 
of an error 


DD DUPLICATE DIMENSIONS. 


Duplicate DIM statements are 
being used to dimension the 
same array, or a DIM statement 
appears in the program after 
default dimensions were 
assumed. 


10 DIVISION BY ZERO. Arith- 
metic expression resulted in at- 
tempted division by zero. Can 
never be done. 


FC ILLEGAL FUNCTION CALL. 


An invalid (out-of-range) value 
was used with a function (e.g., a 
negative number with SQR or a 
negative or very large subscript). 


ID ILLEGAL DIRECT. An illegal 
Programmed Mode keyword 
(e.g., INPUT) was used in im- 
mediate Mode. 





LS STRING TOO LONG. At- 
tempted to create a string longer 
than 255 characters. 


MO MISSING OPERAND. A 

keyword is missing a required 

operand (e.g. CSAVE without a 
program name). 


NF NEXT WITHOUT FOR. The 
index variable in related FOR and 
NEXT statements is not the 
same. Or program was halted 
while in a loop and cannot be 
CONTinued. 


OD OUT OF DATA. When a 
READ statement was executed 
all DATA statements had already 
been read. Or insufficient data 
was included in the program's 
DATA statements. One way to 
avoid this error is to execute a 
RESTORE before READ, if 
appropriate. Or, use an end-of- 
data flag. 


OM OUT OF MEMORY. This 
message indicates one or more 
of the following conditions: 


SSSSCCCSCSCRCSSRBCSRCCS SESS SE 
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e Program too large for available 
memory : 


e An array is too large for avail- 
able memory 


e Too many values for a variable 


e Subroutines or loops are 
nested too deeply 


e Expression(s) too complicated 


To conserve memory space, try 
to: eliminate REM statements... 
re-use variables wherever possi- 
ble...use subroutines to avoid re- 
dundant groups of statements... 
write multiple statements on 
single lines. 


OS OUT OF STRING SPACE. 
Not enough available memory to 
store strings. Use CLEAR to in- 
crease string buffer size. 


OV OVERFLOW. The result of 
an. arithmetic operation was too 
large to be represented in 
BASIC’s range of numbers. 


Caen r rr a SSeS aS Ss SS SSS SS SS SSS Ls ee una 


RG RETURN WITHOUT 
GOSUB. A RETURN statement 
was executed for which a corre- 
sponding GOSUB statement 
could not be found. | 


SN SYNTAX ERROF. Incorrect 
or missing punctuation, an illegal 
character, misspelled keyword or 
function, etc. 


ST STRING FORMULA TOO 
COMPLEX. String expression 
contains too many functions 
and/or operators. Break the ex- 
pression down into smailer 
pieces. 


TM TYPE MISMATCH. A 
numeric value is assigned to a 
String, or vice versa; illegal 
operation combining data types. 


UF UNDEFINED USER FUNC- 
TION. A USR function is called 
before it is defined. 


UL UNDEFINED LINE. Attemp- 
ted branch to a line that is not in 
memory, or deletion of a non- 
existent line. 
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Use this formula to locate char- 


CHARACTER RAM MATRIX 
acter display positions: 
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Starting Address 





To display color, add 1024 to the 


COLOR RAM MATRIX 
character RAM address. 
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To insert a character in a specific memory location, use POKE followed 
by the character matrix address and the character code number. For 
example: 

POKE 12328,65 puts an ‘‘A”’ (code 65) in the memory’s home position. 











To display a character without specifying its location, use PRINT and 
CHR$ statements and the character code. For example, PRINT 
CHR&(65) prints ‘‘A’’ at the cursor’s current position. 
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FUNCTION CHARACTERS 
CODE 

CHR&(7) 

CHR&(8) 


CHR$(10) 


CHR§$(11) 
CHR§$(13) 


FUNCTION 
Ring bell 


Delete one character left of 
cursor 


Carriage return (used with PRINT 
and data/variables) 


Clear screen 


Carriage return (used with PRINT 
only) 





5 1 | i | | , 
1 1 | q 
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ARITHMETIC 
OPERATOR 


PRECEDENCE 





The order in which Aquarius 
does arithmetic operations is 
called OPERATOR 
PRECEDENCE. 


If you combine more than one 
arithmetic operation in the same 
expression (example: 5 + 16/ 
4), which operation does the 
computer do first? Does it add 5 
+ 16, then divide the result by 
4? Or does it divide 16 by 4 and 
add 5 to the result? The order of 
precedence makes a difference 
in the answer. 


Aquarius scans arithmetic and 
logical expressions from left 
right, giving operations this order 
of priority: 


Parentheses 

Exponentiation 

Negation (giving a number a 
negative value, like —5) 
Multiplication and division 
Addition and subtraction 


Example 1: 5* 6+ 4/2 


Aquarius first multiplies 5 * 6, 
then divides 4 by 2. It then adds 
the results of these operations 
(30 + 2) for a final result of 32. 
This is a different result than if 
Aquarius had multiplied 5 * 6, 
then added 4 and divided that 
result by 2, for a final answer of 
17. 


Example 2: 5 * (6 + 4)/ 25 


Aquarius first adds 6 + 4 
(because this operation is in 
parentheses). Then it multiplies 
the result (10) by 5 and divides 
that result (50) by 25. The final 
answer is 2. 





lf there is more than one opera- 
tion of the same kind, Aquarius 
works from left to right, doing the 
left-most operation first. If there 
are parentheses inside parenthe- 
ses, Aquarius works from the in- 
Side out, doing the inner-most 
operations first. 


Example 3: 
(5% (6 + 4)/2)n2 


The first operation Aquarius does 
in this example is to add 6 and 4. 
Now the expression reads (5 * 
10 / 2)a 2. Aquarius sweeps 
through again and performs the 
multiplication and division from 
left to right, since these opera- 
tions are on the same prece- 
dence level. This gives (50/2) a2 
or 25 A2. Finally, 25 is raised to 
the second power, giving a result 
of 625. 
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PRACTICE 
PROGRAMS 





The following programs will 
demonstrate some of the capa- 
bilities of your Aquarius Com- 
puter. Enter and RUN them, for 
practice and for fun. If you have 
a cassette tape recorder, save 
them on tape, then try a few 
modifications of your own. 





“Kaleidoscope” 


10 REM--KALEIDOSCOPE 
20 PRINT CHR$(11) 
25 POKE 12328 + 41,32 


30 M=40: N=24: REM--#0F X 
AND Y 


40 GOTO 160 
60 REM--CA = color address 
70 REM--COLOR PLOT SUBROUTINE 


75 REM--STAY IN RANGE 





80 1FX >M —1THENX = M — 1 
90 IF Y< QO THEN Y = 0 

100 IF Y>N -—- 1THENY =N —-1 
110 IF X< QO THEN X = 0 

115 REM--CALCULATE ADDRESS 

120 PA = 12328 + X + Y * 40 
130 CA = PA + 1024 

140 POKE CA, C 

150 RETURN 

160 REM--START LOOPS 


180 FOR | = O TO M/2 —- 1 
190 FOR J = 010 M/2 — 1 
200K = |1+J 

205 REM--C = COLOR 1 TO 14 
210 C = INT(14 * RND(1) + 1) 
250 REM--8 PLOT POINTS 


CONTINUED ON NEXT PAGE 
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260 X 


I: Y = K: GOSUB 75 
270 X = K: Y = I: GOSUB 75 


220X = M—-IY={N—K: 
GOSUB 75 


290X =M-K:Y=N —-I: 
GOSUB 75 


300 X 


K: Y = N — |: GOSUB 75 


| 


310 X = M — 1: Y = K: GOSUB 75 


320 X = |: Y = N — K: GOSUB 75 
330 X = M — K: Y = |: GOSUB 75 
335 Z = FRE(X) 

340 NEXT J, | 


350 GOTO 160 


For variety, delete line 180 and 
add: 

195.f = J 
Then. change line 340 to: 

340 NEXT J 








“Concentric Circles” 


5 PRINT CHR$(11) 

10 Pl = 3.14159 

20 FOR J = 30 TO 2 STEP -2 
ou FoSaJ 

40 FOR | = 0 70 2 * Pl STEP .1 
50 X = R * COS(I) 

60 Y = R * SIN (I) 

70 PSET (40 + X, 40 + Y) 

80 NEXT | 

90 NEXT J 

See what happens when you 


change the values after STEP in 
lines 20 and 40. 


“Boxes” 

1 GOTO 50 
2CA=A+D+X+40* Y 
3 POKE CA, CP 

4 RETURN 

6 it CP = 16 THEN CP =. 4 

8 iF CP = 8 THEN CP = 9 


12 RETURN 
90 A = 12328 
60 D = 1024 


62 WS = CHRS$(11): PRINT WS 
65 INPUT ‘# 1-12’°; W 
66 IF W< 10RW> 12 THEN 65 


67 W = W-1 
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68 Z = 1 

70 PRINT WS 

75 POKE A + 41, 32 

80 CP = 1 

100 | = 0: J = 39: K = 23 
110 FORX = 110d 

115C =0 

1200 Y = C + 

130 GOSUB 2 
140Y=K-C 

150 GOSUB 2 

152 IF | = 12 AND C = 2 THEN 400 
155 IF C = W THEN 180 
160C = C + 1 

170 GOTO 120. 

180 NEXT X 

200 FORY =|!+CTOK-C 








210C = 0 910 Y = 11: GOSUB 2 
2200X = C +! 920 Y = 12: GOSUB 2 
230 GOSUB 2 930 NEXT X 
24400X=J-C 600 CP = CP + 1 
290 GOSUB 2 610 GOSUB 6 


260 IF C = W THEN 290 620 GOTO 100 
270C =C+1 

280 GOTO 220 

290 NEXT Y 


3900! =l+e+2JeJ-2:K= 
K-Z 


310 CP = CP + 1 

312 GOSUB 6 

315 IF | = 11 THEN 500 
320 GOTO 110 

400 GOTO 62 


mane ie = 
PROGRAMS 


900 FOR X = | TO J 


ia) 











“Palette” 


10 FOR | = 0 TO 7: READ T$(I) 
15 NEXT | 

20 A = 12328: B = 959 

25X = 13 

28 DIM C$(15) 


30 W$ = CHR$(11): REM--WIPE 
SCREEN 


40 PRINT WS 

50 FOR| = 0T06 

60 T = 20 — (LEN(TS(I)))/2 
63 PRINT TAB(T) 

65 PRINT T$(|) 


80 NEXT | 


90 FOR | = 0 TO 15: READ C$(|) 


100 NEXT | 
107 GOTO 150 


110 FOR| = 010 15 

115 PRINT TAB(8—(I<10)) 

117 GOTO 130 

119 REM--1 SPACE IN 120 

120 IF |< 10 THEN PRINT ‘* " 
125 REM--DOT & 4 SPACES IN 130 
130 PRINT I. ":C$(1) 


140 NEXT | 
145 GOTO 230 


150 REM--COLOR SWATCH 
155 FOR | = 070 15 


160 Y=l1+/7 


170 CA =A+X+Y * 40 + 1024 


175 C = | 





177 FORS = 010 3 
180 POKE CA + S,C 

185 NEXT S 

190 FOR L = 0710 11 
191 BG = 7 


192 POKE CA + 4+1L,C * 16 + BG 


194 NEXT L 

200 NEXT | 

210 GOTO 110 

230 PRINT TAB(S): INPUT FC 
240 IF FC > 15 THEN 
250 GOTO 355 

300 REM--OUT OF RANGE 


310 PRINT W$:‘‘Please use 0-15’’: 
CHR$(7):CHRS(7); CHRS(7) 


320 FOR P = 0 TO 1000: NEXT P 
330 GOTO 230 
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355 PRINT WS 


360 PRINT ‘‘FOREGROUND color ="' 
C$(FC) 


372 PRINT: PRINT: PRINT: PRINT 
374 PRINT TAB(8)T$(7) 

380 FOR |. = 0.10 15 

390 Y=|1+7 

400 CA =A+X + Y* 40 + 1024 
410C =| 

420 FORL = 0 T0 19 

430 POKE CA + L, FC * 16 + | 
440 NEXT L,I . 

450 FOR | = 070 15 

460 PRINT TAB(8—(I<10)) 

465 REM--DOT & 4 SPACES in 470 
470 PRINT |;°*. —"’;C$(1) 

480 NEXT | 

















490 INPUT BC 


810C = BC + 16* FC:A=A+ 


1024 
820 PRINT WS 
825 PRINT FC,BC,C 
827 L-= 0 
830 FOR| = ATOA + B 
833 IF L > 255 THEN L = 0 
835 POKE | — 1024,L 


840 POKE I,C 

B47L = 1+ 1 

850 NEXT | 

900 REM--TITLE HEADINGS 


910 DATA MATTEL ELECTRONICS, 
PRESENTS ,AQUARIUS,°*”’, 


--PALETTE-- 


920 DATA Select FOREGROUND Color, 
‘*’* Select BACKGROUND Color 


950 REM--COLORS 





960 DATA Black,Red Green, Yellow, 


Blue, Violet, Light Blue-Green 


970 DATA White, Light Gray, Blue-Green, 
Magenta, Dark Blue 


980 DATA Light Yellow,Light Green, 
Orange, Dark Gray 
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